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ABSTRACT 

Data General's Stand-alone Operating System (SOS) provides 
I/O support to programs in a non-disk environment and in- 
cludes utility programs for software development. SOS can 
be used in systems with at least 8K of core. Systems having 
cassette or magnetic tape drives can use a special set of 
utility programs that includes a command line interpreter 
(CLI). The CLI performs certain file maintenance tasks and 
allows mnemonic loading of utility programs from a master 
cassette or magnetic tape reel. 
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INTRODUCTION 



niTi n 



ENERAL's Stand-alone Operating System performs input/output for programs 
that execute in a non-disk environment. Included in SOS are a number of utility 
programs including the relocatable assembler, extended relocatable loader, symbolic 
text editor, SYSGEN, and the library file editor. SOS routines perform I/O on an 
interrupt driven basis using core buffers unique to each declared device. 

The user communicates with SOS through system command words built into his 
program. Using these system command words, the user can: open and close files, 
get file attributes, read and write a line, determine the value of and change the value 
of NMAX, etc. The program interface used to communicate with SOS is similar to 
that for the Real Time Disk Operating System; in this regard, SOS may be considered 
a subset of RDOS. The RDOS to SOS Interface Program (DSOSI) makes SOS program 
interface RDOS compatible. 

The SOS main program supports by default a full teletype. A full teletype is the 
teletype printer, keyboard, reader and punch. Alternatively, support for the teletype 
printer and keyboard alone may be obtained. Other system devices available are 
the high-speed paper tape reader, high-speed paper tape punch, line printer (both 
80-column and 132-column), card reader, mark sense card reader, plotter, up to 
eight cassette drives, and up to eight magnetic tape drives. 

For systems supporting at least one cassette or magnetic tape unit, included in 
SOS are a Command Line Interpreter (CLI) and a Core Image Loader/Writer. These 
systems may also benefit from the added convenience of operation from a master 
cassette or magnetic tape reel. 

SOS contains two User Application Routines. The first is called SAVRE. which is 
the Save-Restore Program. This program maintains a user-supplied stack to save 
the caller's registers when a subroutine is called, and the program restores the 
information on the stack upon returns. 

The second program is the Command Table Builder (CTB). This program reads 
a command line from the teletypewriter into a user-supplied core block and dissects 
the line into a table of string (byte) pointers and flag bit settings. This table is the 
SOS equivalent to the RDOS COM. CM file. 

For those systems with a Command Line Interpreter (those with one or more cassette 
or magnetic tape units) the user may use the CLI to load the assembler, an absolute 
binary paper tape, cassette file, the text editor, the library file editor, a magnetic 
tape file, the relocatable loader and SYSGEN. Additionally, the CLI may be used 
to initialize or release a cassette or magnetic tape unit, make a save file, or transfer 
a file. 
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The Stand-alone Operating System (SOS) performs I/O 

for nrno-rame t-hat *i«»^. — . *_ _ _ _.. . , 

- r--e- — " cnai execute iu a non-aisK environment. 
SOS routines perform I/O on an interrupt driven basis, 
using core buffers unique to each declared device. The 
program interface used to communicate with SOS is 
similar to that for the Real Time Disk Operating Sys- 
tem (RDOS) as described in DGC Manual 093-000075, 
Chapter 4. In this regard, SOS may be considered a 
subset of RDOS. 

Included in SOS are a number of utility programs in- 
cluding relocatable assembler, extended relocatable 
loader, symbolic text editor, library file editor, and 
SYSGEN. A command line interpreter (CLI) and core 
image loader/writer are included in SOS for systems 
with one or more cassette or magnetic tape drives. 
This CLI allows mnemonic loading of utility programs 
from a master cassette, as well as performing a 
number of file maintenance tasks. 

SOS TAPES 

The SOS library tape (099-000010) contains the main SOS 
program and the drive routines for all SOS I/O devices 
except cassette and magnetic tape drives. In addition, 
the SOS library contains the RDOS to SOS interface pro- 
gram (DSOSI) and two SOS user application routines: 
the save-restore program (SAVRE) and the command 
table builder (CTB); SAVRE and CTB are discussed in 
-Chapter 4. Driver routines for cassette thrives are 
supplied as a separate cassette library (099-000041). 
Driver routines for magnetic tape drives are supplied 
as a separate magnetic tape library (099-000042). 

For systems with neither cassette drives nor magnetic 
tape transports, only the following SOS tapes are supplied. 

Name Number 

SOS Library 099-000010 

SOS Text Editor (RB) 089-000104 

SOS Extended Assembler (RB) 089-000106 

SOS Extended Assembler (AB) 091-000069 

SOS Library File Editor (RB) 089-000081 

SOS Library File Editor (AB) 091-000057 

SOS SYSGEN (RB) 089-000122 

SOS SYSGEN (AB) 091-000070 

RDOS User Parameters 090-000883 

SOS Stand-alone Parameters 090-000498 

SOS User Application Parameters 090-000889 
Extended Assembler Command Definitions 



Nova Basic Instructions 
Floating Point Interpreter 
Operating Systems 
(RB = relocatable binary; AB = absolute binary) 



090-001482 
090-001483 
090-001484 



SOS TAPES (Continued) 

relocatable binary tapes can be used to produce ab- 
solute binary tapes (or core image file for systems 
with cassette or magnetic tape drives) with arbitrary 
I/O configurations. The procedures for config- 
uring these programs is described in Chapter 6, 
Configuring SOS Utility Programs. 

For systems with one or more cassette drives, the 



following 
Name 



*«£U*i*wam»i u\aj wpca axe ouppucu. 



Number 



SOS Cassette Driver Library 099-000041 

Cassette Core Image Loader/Writer(AB) 091-000067 
SOS Relocatable Loader (RB) 089-000120 

SOS CnmmanH I ino Intomrotor /X)D\ nao_nnr>ni 

SOS SYSGE N with Cassette Support (AB) 09 1 - 00007 1 

SOS CLI with Cassette Support (AB) 091-000072 

SOS Relocatable Loader with Cassette 091-000073 

Support (AB) 

SOS 132-column Line Printer Driver 089-000148 

The absolute binary programs with cassette support 
are configured to support cassette units 0, 1, and 2, 
as well as a full teletype, high-speed-paper tape 
reader and punch, and line printer. 

For systems with one or more magnetic tape trans- 
ports, the following additional SOS tapes are supplied: 

Name Number 

SOS Magnetic Tape Driver Library 099-000042 

Magnetic Tape Core Image Loader/ 091-000068 

Writer (AB) 

SOS Relocatable Loader (RB) 089-000120 

SOS Command Line Interpreter (RB) 089-000121 

SOS SYSGEN with Magnetic Tape 091-000074 

Support (AB) 

SOS CLI with Magnetic Tape Support(AB) 091-000075 

SOS Relocatable Loader with Magnetic 091-000076 

Tape Support (AB) 

SOS 132-column Line Printer Driver 089-000148 

The absolute binary programs with magnetic tape 
support are configured to support magnetic tape units 
0, 1, and 2, as well as a full teletype, high-speed 
paper tape reader and punch, and line printer. 

LOADING SOS 



The absolute binary programs listed above are con- 
figured to support a full teletype, high-speed paper 
tape reader and punch, and line printer. The 



SOS I/O support software is loaded by the extended stand- 
alone relocatable loader (091-000038) or the SOS relocat- 
able loader. To load the main SOS program, the symbol 
. SOS must have been declared as external normal in a 
previously loaded program. When the RDOS to SOS Inter- 
face Program (DSOSI) is used, the symbol . DSI must be 
declared external normal instead of . SOS; DSOSI when 
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CHAPTER 1 - SUMMARY DESCRIPTION OF SOS 



LOADING SOS (Continued) 

loaded causes the SOS main program to be loaded as well. 

The SOS main program supports a full teletype (tele- 
type keyboard, printer, reader, and punch) by default. 
Support for the other system devices (high-speed paper 
tape reader, high-speed paper tape punch, line printer, 
card reader, plotter, up to eight cassette drives, and 
up to eight magnetic tape transports) may be obtained 
by loading the appropriate drivers. Support for tele- 
type printer and keyboard (instead of a full teletype) 
may be obtained by loading the small teletype driver. 
Table 1 lists the symbols that must be declared exter- 
nal normal in order to load each of these optional 
drivers. 

The cassette and magnetic tape drivers are contained in 
two libraries separate from the SOS library: the SOS 
cassette library and the SOS magnetic tape library. 
Loading any control table/core buffer for a cassette or 
magnetic tape unit automatically results in loading the 
associated driver (CTADR or MTADR) and control 
table/core buffers for all units whose number is less 
than the specified number. Thus loading CTU4 auto- 
matically results in loading CTADR, CTUO, CTU1, 
CTU2 and CTU3 as well. 

SOS I/O DEVICES 

A primary difference between RDOS and SOS is that 
under RDOS files are assigned by file name to temp- 
orary channel numbers, while under SOS channel 
numbers are fixed and always denote the same device 
(file). File names are not recognized by SOS. 

The RDOS to SOS Interface Program (DSOSI) makes 
the SOS program interface RDOS compatible. Using 
DSOSI, user programs open devices (files) by name on 
RDOS channel numbers and reference them thereafter 
by RDOS channel numbers (0-7). Mixing of calls 
within a program is not permitted; each user program 
must be consistent in issuing either RDOS or SOS 
commands (but not both) to perform I/O. Programs 
that use DSOSI should contain only RDOS commands 
and must declare . DSI (not . SOS) as an external nor- 
mal. When the program is loaded, external normal 
. DSI will cause DSOSI to be loaded from the SOS 
library. 

MASTER CASSETTE OR MAGNETIC TAPE OPERATION 

Systems that include one or more cassette or magnetic 
tape drives may benefit from the added convenience of 
operation from a master cassette or magnetic tape 
reel. A master reel contains in core image form a 
core image loader/writer, command line interpreter. 
text editor, extended assembler, extended relocatable 



MASTER CASSETTE OR MAGNETIC TAPE OPERATION 
(Continued) 

loader, library file editor, and SYSGEN. When the 
master reel is loaded on cassette or magnetic tape 
unit 0, the core image loader /writer can be boot- 
strapped and the other programs can be loaded by 
mnemonic commands to the command line inter- 
preter. The command line interpreter also performs 
a number of basic file maintenance tasks. 

To obtain the maximum convenience from master reel 
operation in software development, more than one 
cassette or magnetic tape unit should be available. 
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TABLE I 



Program ' 


Tape 


External Symboi 


function 


(Title) 




For Loading 




STTY 


SOS library 


.STTY 


Small teletype driver (keyboard 
and printer only. ) 


PTRDR 


SOS library 


.PTRD 


High-speed paper tape reader 
driver. 


PTPDR 


SOS library 


.PTPD 


High-speed paper tape punch 
driver. 


LPTDR 


SOS library 


• LPTD 


Line printer driver. 


CDRDR 


SOS library 


.CDRD 


Card reader driver. 


PLTDR 


SOS library 


.PLTD 


Plotter driver. 


CTADR 


Cassette 


• CTAD 


Cassette driver containing con- 




library 




trol table/core buffer to support 
cassette unit 0. 


CTU1 


Cassette 


.CTU1 


Control table/core buffer to 




library 




support cassette unit 1 . 


CTU2 


Cassette 


.CTU2 


Control table/core buffer to 


• 


library 


• 


support cassette unit 2. 


CTU7 


Cassette 


.CTU7 


Control table/core buffer to 




library 




support cassette unit 7. 


MTADR 


Magnetic 


.MTAD 


Magnetic tape drive containing 


.. 


tape library 




control table/core buffer to. 
support magnetic tape unit 0. 


MTU1 


Magnetic 


.MTU1 


Control table/core buffer to 




tape library 




support magnetic tape unit 1. 


MTU2 


Magnetic 


.MTU2 


Control table/core buffer to 


• 


tape library 


• 


support magnetic tape unit 2. 


MTU7 


Magnetic 


.MTU7 


Control table/core buffer to 




tape library 




support magnetic tape unit 7. 



TABLE OF EXTERNAL NORMAL SYMBOLS FOR DRIVERS 
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SOS can provide to user programs I/O support for 
teletype keyboard input ($TTI), teletype printer 
($TTO), teletype paper tape reader ($TTR), teletype 
paper tape punch ($TTP), high-speed paper tape 
reader ($PTR), high-speed paper tape punch ($PTP), 
line printer ($LPT), card reader ($CDR), plotter 
($PLT), eight cassette drives (CTO, CT1, . . . CT7) 
and eight 9-track magnetic tape drives (MTO, MT1, . , . 
MT7). Additional support capability may be added to 
SOS through the addition of driver routines to the 
SOS libraries as described in Appendix B. 

SOS DEVICE DRIVER ROUTINES 

SOS device driver routines are contained in three 
libraries: the SOS library, the SOS cassette library, 
and the SOS magnetic table library. The SOS Library 
contains the following routines: 

Name Purpose 

CTB command table builder (SOS user sub- 

routine). 
- SAVRE save/return routine (SOS user sub- 

routine). 

DSOSI RDOS to SOS interface program. 

PLTDR plotter driver. 

CDRDR card reader driver. 

PTRDR paper tape reader driver. 

LPTDR line printer driver. 

PTPDR paper tape punch driver. 

STTYDR small teletype driver ($TTI, $TTO only). 

SOS main program of SOS. 

BTTYDR full teletype driver ($TTI, $TTO, $TTR, 

$TTP) 

The SOS cassette library contains the cassette unit 
driver modules: 

Name Purpose 

CTU1 Buffer and control table for cassette 

unit 1 (CT1) 
CTU2 Buffer and control table for cassette 

unit 2 (CT2) 



CHAPTER 2 - SOS I/O SUPPORT 

The SOS magnetic tape library contains the magnetic 
tape unit driver modules: 

Name Purpose 

MTU1 Buffer and control table for magnetic 

tape unit 1 (MT1). 
MTU2 Buffer and control table for magnetic 

tape unit 2 (MT2). 



MTU7 Buffer and control table for magnetic 

tape unit 7 (MT7). 
MTADR Magnetic tape driver (includes buffer 

and control table for magnetic tape 

unit (MTO)). 

SPECIFYING DEVICES BY NAME OR BY CHANNEL 

Under SOS, user programs can perform I/O through 
commands to SOS. These commands are discussed in 
Chapter 3. When running programs under the RDOS 
to SOS interface program (DSOSI) devices are spec- 
ified in commands by their device names. When 
DSOSI is not used, devices are specified by their 
fixed channel numbers. The following is a table of 
these numbers: 



Device Name 


Channel Number 


$PLT 


6 


$TTP 


10 


$CDR 


11 


$TTO 


12 


$TTI 


13 


$LPT 


14 


$PTR 


15 


$PTP 


16 


$TTR 


17 


MTO 


20 


MT1 


21 


MT7 


27 


CTO 


30 


CT1 


.31 



CTU7 Buffer and control table for cassette 

unit 7 (CT7) 
CTADR Cassette driver (includes buffer and 

control table for cassette unit (CTO)). 



CT7 



37 
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CHAPTER 2 - SOS I/O SUPPORT 

SOS UTILITY PROGRAM I/O 

Each of the utility programs Included in SOS (except 
the core image loader/writer and text editor) is 
supplied in two forms: a relocatable binary form and 
an absolute binary form. The relocatable binary form 
must be configured as explained in Chapter 6, and 
may be configured with arbitrary I/O support. The 
absolute binary is preconfigured with support for full 
teletype ($TTI. $TTO, $TTR, $TTP), high-speed paper 
tape reader/punch ($PTR, $PTP) and line printer ($LPT). 
For systems that include one or more cassette drives, 
they are also configured with support for three cassette 
drives (CTO, CT1, and CT2). For systems that 
include one or more magnetic tape drives, they are 
also configured for three magnetic tape drives (MTO, 
MT1, and MT2). 
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The user communicates with the Stand-alone Operating 
System through system command words assembled into 

his rvrntrrnm 

SYSTEM COMMAND FORMAT 

All SOS commands have the same format: 



SYSTEM COMMAND FORMAT (Continued) 

For example, the following instructions specify a write 
to channel 16: 



. SYSTM 
command 
error return 
normal return 



;STATUS IN AC2 

;AC*S AND CARRY PRESERVED 



C16: 



LDA 2, C16 
.SYSTM 

.WRS CPU 

JSR EOF 



16 



;CPU=OCTAL 77 



The mnemonic . SYSTM and the SOS command words are STATUS ON RETURN FROM SYSTEM 



recognized as legal mnemonics by the DGC Stand-alone 
Relocatable Assembler and the RDOS Relocatable 
Assembler. 

Itie mnemonic .SYSTM must immediately precede the 
command. Appearance of the mnemonic .SYSTM re- 
sults in the assembly of a 

JSR @ 17 

instruction which allows system communication through 
the main system entry address stored in page zero. The 
system command word must be assembled as the word 
following the . SYSTM. 

Once system action is completed, normal return is made 
to the second instruction after the system command word. 
If.an exceptional condition is detected, return is made to 
the first instruction following the system command word. 

System commands have the form either of a mnemonic 

or a mnpmnnir fr»llr»uw»H Kw o ^k nnnn i «.. — i 



command 



or 



command n 



where n is a digit that represents the fixed I/O channel 
(device) number (0-76g). When no I/O channel is needed 
for command execution, the command word, command , 
appears alone in the instruction. If the command requires 
arguments, these are passed in the accumulators. 

One argument commonly passed in an accumulator is a 
byte pointer. A byte pointer contains the word address 
in bits 0-14, which contain or will receive the byte. Bit 
15 specifies which half (0 left; 1 right). Note that this is 
the reverse of the byte pointer as specified in "How to 
Use the Nova Computers. " To use the subroutine shown 
on page 2-21 of the manual, change the MOV SZC 
instruction to a MOV SNC instruction. 

Any command requiring a channel number n need not 
specify this number in the command itself. By specifying 
octal 77 (the device code of the CPU), as the channel 
number in the instruction, the system will use instead 
the number passed in AC2. 



Status of the accumulators upon return from the system 
is as follows: 

If the system returns no information as a result of the 
call, the Carry and all accumulators except AC3 will 
be preserved. 

AC2 is used when an exceptional return is made to re- 
turn a numeric error code. Error codes are listed by 
number at the end of this chapter and the applicable 
codes are listed for each command. 

AC3 is destroyed by . SYSTM (as it is by the use of 
JSR). On return from the system, however, AC3 is 
loaded from the contents of memory location 000 16g. 
This location is defined as a permanent symbol by the 
DGC Assembler and has the name USP (User Stack 
Pointer). A convenient method of saving AC3 is to store 
it in location 000l6g before issuing . SYSTM. 



The following is a list of the command word mnemonics: 

.SYSI Initialize SOS devices. 

.OPEN Open a file. 

.CLOSE Close a file. 

. RESET Close all open files. 

.GTATR Get the file attributes. 

. RDS Read sequential characters. 

. RDL Read sequential lines. 

. WRS Write sequential characters. 

.WRL Write sequential lines. 

. GCHAR Read a character from the TTI. 

. PCHAR Write a character to the TTO. 

. MEM Determine available memory space. 

. MEMI Allocate an increment of memory. 

The SOS commands above are a subset of the RDOS 
commands. All other RDOS commands, including .RTN, 
result in an error return with the error code: 

2 (ERICM -- Illegal system command) 
returned in AC2. 
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CHAPTER 3 - SOS COMMANDS 

INPUT/OUTPUT COMMANDS 

All I/O is handled by system I/O commands. These 
commands require a channel number to be given in the 
second field of the command word. If the channel 
number is 77, then AC2 must contain the desired chan- 
nel number. The system provides two basic modes for 
reading and writing files. 

The first mode is the line mode, where data read or 
written is assumed to consist of ASCII character strings 
terminated by either carriage returns, form feeds or nulls. 
In this mode, the system handles all device -dependent 
editing at the device driver level. For example, line 
feeds are ignored on paper tape input devices and 
supplied after carriage returns on all paper tape output 
devices. Further, reading and writing never require byte 
counts, since reading continues until a carriage return 
is read and writing proceeds until a carriage return is 
written. The line mode commands are .RDL and .WRL. 

The second mode is unedited sequential mode. In this 
- mode, -data is transmitted exactly as read from the file 
or device. No assumption is made by the system as to 
the nature of this information. Thus, this mode would 
always be used for processing binary files. This mode 
requires the user program to specify byte counts neces- 
sary to satisfy a particular read or write request. The 
sequential mode commands are .RDS and .WRS. 

I nitialization of Communications (.SYSI) 

The . SYSI command must be issued before any other 
SOS commands are used. It initializes all tables, 
clears each SOS device, restores NMAX to its value at 
load time, and enables interrupts from all devices. Ad- 
ditional .SYSI commands can be given if the user wishes 
to clear devices on restarts. 
The format of the command is: 



. SYSTM 
.SYSI 

e rror return 
normal return 



-.INITIALIZE SOS 

-.NEVER TAKEN 

;AC'S AND CARRY RESERVED 



Open a File (.OPEN) (Continued) 

The .OPEN command results in the initialization of the 
control table for the device, the output of leader on 
paper tape devices, or a prompt message for input 
devices requiring user intervention. The format of the 
. OPEN command is: 



.SYSTM 
.OPEN n 
error return 
normal return 



;OPEN CHANNEL n 



Possible errors resulting from the .OPEN command are: 
AC2 Mnemonic Meaning 



ERFNO 

3 ERICD 

12 ERDLE 

31 ERSEL 



Illegal channel number. 
Illegal command for device. 
File doesn't exist. 
Unit not properly selected. 



Open a File (. OPEN) 

Before other I/O commands can be used, a device must 
be opened with the . OPEN command. Issuance of the 
. OPEN command initially links a channel to a particular 
file. This association between a file and channel number can 
be broken by using the . CLOSE command; and all currently 
open files can be closed using the . RESET command. 
The contents of AC1 are used as a mask to control the 
device characteristics that are set for the duration of the 
OPEN For every bit set in the word, the corresponding 
device characteristic (See .GTATR command) is inhibited. 
If AC1 contains 0, then no characteristics are inhibited. 
If the device is attribute protected (see .GTATR command) 
the mask is ignored. 
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Close a File (.CLOSE) 

After use, files may be closed to insure an orderly 
ending sequence. The format of the .CLOSE command 
is: 

.SYSTM 

.CLOSE n -.CLOSE CHANNEL n 

error return 

normal return 

Possible errors resulting from a .CLOSE command are: 
AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

15 ERFOP File not open. 

Close All Files (.RESET) 

The command causes all currently open files to be 
closed. The format of the . RESET command is: 

.SYSTM 
. RESET 
error return 
normal return 



The error return from this command is never taken. 



THE STAND-ALONE OPERATING SYSTEM 



CHAPTER 3 - SOS COMMANDS 



Get File Attributes (.GTATR) 
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acteristics of a device. To obtain attributes, the file 
must be opened (see . OPEN command). The number of 
the channel is given in the system command. The for- 
mat of the .GTATR command is: 



.SY&1M 

.GTATR n 
error return 
normal return 



;CHANNELn 



t~>pwil rCLUi.ll, rtUU CUUU11110 tllC 111C aiLLJ.UUl.es. 111C dtLtll" 

bute settings and their meanings are given below: 



Bit 
iBG 



Mnemonic 
ATRP 



1B1 ATCHA 



1B14 ATPER 



1B15 ATWP 



Meaning 

Device is read protected. 

Device is attribute protected; a 
file or device with this attribute 
contains unsuppressable device 
characteristics (e. g. , the $TTI 
is attribute protected and hence 
always contains the DCKEY 
characteristic while it is open. ) 

Permanent file. All devices 
are permanent files. 
Device is write protected. 



AC1 contains the device characteristics of the file. The 
bit/characteristic correspondence used in interpreting 
the bit configuration returned in AC1 is shown below: 



Bit 
1B0 



Mnemonic 
DCDIR 



1B1 DCC80 

1B2 DCLTU 

1B3 DCFFO 

1B4 DCFWD 

1B6 DCLAC 

1B7 DCPCK 



Meaning 

Directory device. SOS recog- 
nizes the characteristic as 
indicative of a data channel 
block transfer device. 

An 80 -column device. Appli- 
cable to the card reader and 
line printer. 

Device changing lower case 
ASCII to upper case. 

Device requiring form feeds 
on opening. 

Full word device (reads or 
writes more than one byte. ) 

Output device requiring line 
feeds after carriage returns. 

Input device requiring a parity 
check. Output device requiring 
parity to be computed. 



Get File Attributes (. GTATR ) (Continued) 






1B8 DCRAT Output device requiring a rubout 

after every tabT 

1B9 DCNAF Output device requiring nulls 

after every form feed. 

1B10 DCKEY A keyboard input device. 

1B11 DCTO A keyboard output device. 

1B12 DCCNF Output device without form feed 

hardware. 

1B13 DCIDI Device requiring operator 

intervention. 

1B14 DCCGN Output device without tabbing 

hardware. 

1B15 DCCPO Output device requiring leader/ 

trailer. 

Possible errors resulting from a . GTATR command 
are: 

AC2 Mnemonic Meaning 




15 



ERFNO 
ERFOP 



Illegal channel number. 
Attempt to get attributes 
of an unopened file. 



Read a Line ( , RDL* 



Thjs command causes an ASCII line, having even 
parity, to be read. ACO must contain a byte pointer to 
the starting byte address within the user area into 
which the line will be read. 

Reading will terminate normally after transmitting 
either a carriage return, null, or a form feed to the user. 
Reading will terminate abnormally after transmission 
of 132 characters (decimal) without detecting a carriage 
return, null, or form feed, upon detection of a parity error, 
or upon end of file. In all cases, the byte count read 
will be returned in AC1. If the read is terminated 
because of a parity error, the character having incor- 
rect parity will be stored (high order bit zero) as the 
last character read. The byte pointer to the character 
can always be computed as : 

C(AC0) + C(AC1) - 1 

where: C(x) means "the contents of x. 
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Read a Line (.RDL) (Continued) 

The format of the . RDL command is: 



. SYSTM 
.RDL n 
error return 
normal return 



;READ FROM CHANNEL n 



Possible errors resulting from a .RDL command are: 
AC2 Mnemonic Meaning 






ERFNO 


Illegal channel number. 


3 


ERICD 


Illegal command for device. 


6 


EREOF 


End of file. 


7 


ERRPR 


Attempt to read a read pro- 
tected file. 


IS 


ERFOP 


File not open. 


22 


ERLLI 


Line limit (132 characters) 
exceeded. 


24 


ERPAR 


Parity error. 


30 


ERFIL 


File read error. 


Write a Line(.WRL) 





The command assumes an ASCII file. ACO must con- 
tain a byte pointer to the starting byte address within 
the user area from which characters will be read. 

Writing will terminate normally upon writing a null, 
carriage return, or a form feed, and abnormally after 
transmission of 132 (decimal) characters without detec- 
tion of a carriage return, a null, or a form feed. In 
either case, AC1 will contain, upon termination, the 
number of bytes read from the user area to complete 
the request. The termination of a write line on a null 
allows for formatting output without forcing a carriage 
return. 

The format of the . WRL command is: 



. SYSTM 
.WRL n 
error return 
normal return 



;WRITE TO CHANNEL n 



Possible errors resulting from the .WRL command are: 
AC2 Mnemonic Meaning 



Illegal channel number. 
Illegal command for device. 
Attempt to write a write pro- 
tected file. 
File not open. 
Line limit (132 characters) 
exceeded. 






ERFNO 


3 


ERICD 


10 


ERWPR 


15 


ERFOP 


22 


ERLLI 



Read Sequential (.RDS) 

Sequential mode transmits data exactly as read from the 
file. ACO must contain a byte pointer to the starting 
byte address within the user area into which the data 
will be read and AC1 must contain the number of bytes 
to be read. The format of the . RDS command is: 



. SYSTM 
.RDS n 
error return 
normal return 



;READ FROM CHANNEL n 



Possible errors resulting from a . RDS command are: 



AC2 Mnemonic Meaning 






ERFNO 


Illegal channel number. 


3 


ERICD 


Illegal command for device, 


6 


EREOF 


End of file. 


7 


ERRPR 


Attempt to read a read-pro 
tected file. 


15 


ERFOP 


File not open. 


30 


ERFIL 


File read error. 



Upon end of file the partial count will be returned in 
AC1. 

Write Sequential (.WRS) 

. WRS transmits data exactly as read from the user area. 
ACO must contain a byte pointer to the starting address 
of the data within the user area and AC1 must contain 
the number of bytes to be written. The format of the 
.WRS command is: 



.SYSTM 
.WRS n 
error return 
normal return 



.WRITE TO CHANNEL n 



Possible errors resulting from a .WRS command are: 
AC2 Mnemonic Meaning 



ERFNO 

3 ERICD 

10 ERWPR 

15 ERFOP 



Illegal channel number. 
Illegal command for device. 
Attempt to write a write 
protected file. 
File not open. 
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TELETYPEWRITER COMMANDS 

Buffered- transfer of single characters between the tele- 
type and ACO is handled by the commands . GCHAR and 
. PCHAR. No channel number is required for the com- 
mands, and the teletype is always considered "open" to 
them. 

Get a Character (. GCHAR) 

The command returns a character typed from the tele- 
type in ACO, The character is right -justified in ACO 
with bits 0-8 cleared. No channel is required; the TTI 
is always used as input for this command. The format 
of the . GCHAR command is: 

. SYSTM 
. GCHAR 
error return 
normal return 

No error return is possible from this command. 

Put a Character (. PCHAR) 

This command transmits a character in ACO, bits 9-15, 
to the teletypewriter. No channel is required; the TTO 
is always used as output for this command. The format 
of the . PCHAR command is: 

. SYSTM 
.PCHAR 
error return 
normal return 
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MEMORY COMMANDS (Continued) 

The highest memory address available (HMA) is 
usually the first word below the Binary Loader. If a user 
symbol table has been loaded at the high end of user 
memory, the high memory address will be the first 
word below the user symbol table. 

The . MEM command returns both the current value of 
NMAX and HMA. The . MEMI command allows the user 
to adjust the value of NMAX. 

Determine Available Memory (. MEM) 

This command returns the current value of NMAX in AC1 
and the value of HMA in AGO. HMA represents either 
the bottom of the binary loader or the end of the user 
symbol table. A SUB 1,0 determines the limit of mem- 
ory available to the user program. The format of the 
. MEM command is: 

. SYSTM 
.MEM 

error return 
normal return 



no error return is possible from this command. 

MEMORY COMMANDS 

Upon the completion of a relocatable load, the Stand- 
alone Operating System resides in lower memory, among 
various user or system programs comprising the load 
module. Memory then looks, essentially, as follows: 



user program 



SOS 



system program 



user program 



top of memory HMA 
(highest memory ad- 
dress available) 
NMAX (first location 
available above loaded 
programs) 



There are no error returns from this command. 

Change NMAX (. MEMI) 

This command allows the user to increase or decrease 
the value of NMAX. The increment or decrement (in 
two's complement) is passed in ACO. The command 
causes the value of NMAX to be updated in the User 
Status Table and the new NMAX to be returned in AC1. 
The format of the command is : 

. SYSTM 
.MEMI 
error return 
normal return 



NMAX will not be changed if the new value of NMAX 
would be higher than HMA. No check is made as to 
whether or not the user decreases NMAX below its 
original value as determined at relocatable load time. 

Whenever a program requires memory space above the 
loaded program, a . MEMI should be executed first to 
allocate the number of words needed. The allocated 
memory space may be used by programs for buffers, 
user stacks, temporary storage, etc. There is one 
error return from a .MEMI command: 

AC2 Mnemonic Meaning 



26 ERMEM 



— bottom of memory 



Attempt to allocate more 
memory than available . 
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ERROR MESSAGES 



Code 




6 

7 

10 

12 
15 



22 
24 
26 
30 
31 



Mnemonic 
ERF NO 



ERICM 
ERICD 



EREOF 

ERRPR 

ERWPR 

ERDLE 
ERFOP 



ERLLI 

ERPAR 

ERMEM 

ERFIL 

EP.SEL 



Meaning 



Applicable 
Commands 



Illegal channel number. .OPEN 

.CLOSE 
.GTATR 
.RDL 
.RDS 
.WRL 
.WRS 



Illegal system command. 

Illegal command for 
device. 



End of file. 

Attempt to read a read 
protected file. 

Attempt to write a write 
protected file. 

File does not exist. 

File not opened. 



Line limit exceeded on 
read or write line. 

Parity error on read 
line. 

Attempt to allocate more 
memory than available. 

File read error. 

Unit not properly 
selected. 



.RDL 

.RDS 

.WRL 

.WRS 

.OPEN 

.RDL 
.RDS 

.RDL 
.RDS 

.WRL 
.WRS 

.OPEN 

. GTATR 

.CLOSE 

.RDL 

.RDS 

.WRL 

.WRS 

.RDL 
.WRL 

.RDL 



, MEMI 

, RDL 
.RDS 

.OPEN 



DEVICE RESPONSE TO SOS COMMANDS 

This section describes the functions performed by the 
SOS I/O commands, as applied to each of the devices 
supported by DGC. 



$PLT 

.OPEN 
.CLOSE 

.WRS 

.WRL 



Device is initialized. 

Device is reinitialized after outstanding 

I/O is complete. 

The specified bytes are output to the 

device, unedited. 

Illegal command to this device. 



DEVICE RESPONSE TO SOS COMMANDS (ContM) 



$TTP 

.OPEN 
.CLOSE 

.WRS 

.WRL 



$CDR 
.OPEN 



.CLOSE 

.RDS 



.RDL 



Device is initialized; leader is punched. 

Device is reinitialized after outstanding 

I/O is complete; trailer is punched. 

The specified bytes are output to the device, 

unedited. 

The ASCII string is output to the device 

with rubout characters inserted after tabs, 

a line feed inserted after carriage returns, 

and nulls inserted after form feeds. 



Device is initialized; a prompt message 
is written and a response is necessary 
for the program to continue. 
Device is reinitialized. 
The specified bytes are read into the user 
area from the device, unedited. Each pair 
of bytes read represents one fulLcolumn of 
the card. Bits 4-7 of the first byte represent 
card rows 12, 11, 0, and 1 respectively. 

Bits 0-7 of the second byte represent card 
rows 2-9 respectively. A one in bit of the 
first byte of a pair indicates end of card. 
No other meaningful data is included in 
this byte pair. 

The 80- character ASCII string is read 
into the user area from the device. If 
the characteristic DCCB0 was suppressed 
on the . OPEN, then 72 columns are read. 
The translation from Hollerith is per- 
formed in the card reader driver. A 
12-11-0-1-2-3-4-5-6-7-8-9 punch causes 
end of file. The byte count returned to the 
user reflects the last non-blank character 
on the card. 



$TTO 

.OPEN 
. CLOSE 

.WRS 

.WRL 



Device is initialized. 

Device is reinitialized after outstanding 

I/O is complete. 

The specified bytes are output to the 

device, unedited. 

The ASCII string is output to the device 

with simulated tabbing, a line feed 

inserted after carriage return, and nulls 

inserted after form feeds. 
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.OPEN 

.CLOSE 

.RDS 

.RDL 



Device is initialized. 
Device is reinitialized. 
The specified bytes are read into the user 
areafrom the rlpvirt. ,.r*t>At tt >j 
The ASCII string is read into the user 
area from the device. The input stream is 
is echoed on the $TTO. A rubout char- 
acter deletes the previous input character 
and causes a back arrow to be echoed. 
The shift L character causes the entire 
input string to be deleted. Line feeds are 
ignored. 



$TTR 
.OPEN 



Device is initialized; a prompt message is 

written and a response is necessary for 

the program to continue. 
. CLOSE Device is reinitialized. 
. RDS The specified bytes are read into the user 

area from the device, unedited 
• RDL The ASCII string is read into the user 

area from the device. Rubouts, line feeds 

and nulls are ignored. 

CTA (see also Appendix C, SOS Cassette and 
Magnetic Tape Files) 

. OPEN The specified file is located on the tape 

reel, and the read/write head positioned 

tn th#> fil*» ma -vlr ft^-n^ATl:..,- 

.CLOSE Device is reinitialized. Following write 
operations, the last partial block is out- 
put to the file (padded with nulls if nec- 
essary) and two end of file marks are 
written. 

. RDS The specified bytes are read into the 

user area from the file, unedited. 

. RDL The ASCII string is read into the user 

area from the file. Rubouts, line feeds 
and nulls are ignored. 

. WRS The specified bytes are output to the 

file, unedited. 

. WRL The ASCII string is output to the file. 

$LPT 

.OPEN Device is initialized. 

. CLOSE Device is reinitialized; a form feed 

character is output. 
. WRS The specified bytes are output to the 

device, unedited. 
. WRL The ASCII string is output to the device 

with simulated tabbing, and line feeds 

are inserted after carriage returns. 



DEVICE RESPONSES TO SOS COMMANDS (Cont'd! 
$LPT (Cont'd) 

NOTE: The system can accept 132-column printouts. 
Tape number 089-000148 must be loaded in order to 
accomplish this. The tope can be loaded by editing 
i>. iniu „.„. -j,^,...,,, u^aiy, Dy use of LFE, cnereby 
deleting the 80- column device driver. Or the tape 
(#089-000148) can be loaded before the system library 
tope, tiuis replacing the 80-column device driver for 
the 132-column device driver. 

$PTR 

. OPEN Device is initialized; a prompt message is 

written and a response is necessary for 

the program to continue. 
.CLOSE Device is reinitialized. 
. RDS The specified bytes are read into the user 

area from the device, unedited. 
. RDL The ASCII string is read into the user area 

from the device. Rubouts, line feeds, and 

nulls are ignored. 

$PTP 

. OPEN Device is initialized; leader is punched. 

. CLOSE Device is reinitialized after outstanding 

I/O is complete; trailer is punched. 
. WRS The specified bytes are output to the 

device, unedited. 
. WRL The ASCII string is output to the device 

with rubouts inserted after tabs, a line 

feed after a carriage return, and nulls 

after a form feed. 

MIA (See also Appendix C , SOS Cassette and 
Magnetic Tape Files) 

. OPEN The specified file is located on the tape 

reel, and the read/write head positioned 
to the file mark preceding. 

.CLOSE Device is reinitialized. Following write 
operations, the last partial block is out- 
put to the file (padded with nulls if nec- 
essary) and two end of files marks are 
written. 

. RDS The specified bytes are read into the user 

area from the file, unedited. 

. RDL The ASCII string is read into the user area 

from the file. Rubouts, line feeds and nulls 
are ignored. 

. WRS The specified bytes are output to the file, 

unedited. 

. WRL The ASCII string is output to the file. 
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SAVE -RESTORE PROGRAM (SAVRE) 
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the caller's registers (3 accumulators, 2 temporary 
storage locations, and the caller's return location) 
when a subroutine is called, and the program restores 
the information on the stack upon returns. The User 
Stack Pointer (USP) always points to the executing sub- 
routine's stack frame. This subroutine may then ac- 
cess any of the caller's registers, as well as any of 
its own, by using the stack displacements defined in the 
SOS User Application Parameter Tape (Appendix D). 

The user must supply the stack before any of the SOS 
user application routines can be used. To provide the 
stack, the user merely stores a beginning address for 
the stack into the USP. The address stored in the cell 
must point to a core block large enough to meet the 
user stack requirements. No stack overflow check is 
made. If the stack is used only with the SOS library 
routines, then the value of SOSEC in the SOS User 
Application Parameter Tape gives the maximum num- 
ber of 6 -location frames necessary. 

The various features of the SAVRE program are illus- 
trated in the following example of step-by -step use of 
the stack: 

1. To supply the stack, the user may allocate a fixed 
block of core starting at NMAX: 



. SYSTM ;GET NMAX INTO AC1 

.MEM 

JMP . ;ERROR 

STA 1, USP ;INITIALIZE START OF STACK 
LDA 0, STKSZ 

. SYSTM ;UPDATE NMAX 

.MEMI 

JMP . ;NOT ENOUGH CORE AVAIL- 

ABLE 



STKSZ: SOSEC+3*SSEL 



TOTAL STACK SIZE = SOS 
ENTRY COUNT + USER'S 
ENTRY COUNT * ENTRY 
LENGTH 



Or, instead of starting at NMAX, the user may 
alternatively allocate any fixed block of core: 



SAVE -RESTORE PROGRAM (SAVRE) (Continued) 

2. To save the caller's registers when a sub- 
routine is entered via a JSR SUBR instruction: 

.EXTN SAVR,. RETR 
SUBR: STA 3, @USP ;SAVE -RETURN LOCA- 

TION IN STACK 
SAVR ;SAVE REGISTERS 

• ;AC3 — SUBR' s FRAME 

3. To access the caller's registers (which are 
intact when the subroutine is entered): 



STA 2, OAC0, 3 ;RETURN AC2 IN CALLER'S ACO 
ISZ OAC2, 3 ;INCREMENT THE RETURNED AC2 
ISZORTR, 3 ;INCREMENT RETURN LOCA- 

;TION COUNTER 
DSZ OT1, 3 ;DECREMENT CALLER'S 

; TEMPORARY 
STA 1, TO, 3 ;STORE MY OWN TEMPORARY 

4. To return to the calling subroutine: 
RETR ;RETURN TO CALLER 

5. To pop multiple stack levels, i. e. , make an 
exceptional return, the external command, 
ERETR, has been defined. To illustrate use 
of this feature, consider five subroutines: 

A, B, C, D, and E, executing at three levels: 
1, 2, and 3. 

Subroutine A executes at level 1. Subroutines 

B, C, and D execute at level 2. Subroutine E 
executes at level 3. Subroutine A calls B C 
and D, each of which may call E. 

When a special condition is encountered by B, 

C, D, or E, subroutine A may want to regain 
immediate control. This is achieved by per- 
forming the ERETR in subroutine 3, provided 
that subroutine A has performed the logic 
shown below and on the page following. 

.EXTD ERAD, ERUSP 
. EXTN ERETR 



A: 



STA 3, @USP 
SAVR 



;SAVE REGISTERS 



LDA 0, STACK ;LOAD STACK POINTER 

STA 0, USP ;STORE IN USP 

STACK: .+"l 

. BLK SOSEC*SSEL ;SOS SIZE IS ADEQUATE 



LDA 0, AERAD 
STA 0, ERAD 

STA 3, ERUSP 



; STORE EXCEPTIONAL 
;RETURN ADDRESS 
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SAVE RESTORE PROGRAM (SAVRE) (Continued) 
5. To make an exceptional return (continued) 

JSR B 
JSR C 
JSR D 



AERAD: SPECR 



SPECR: 



VAR: 



LDA 0, VAR 
STA 0.OAC1.3 



. BLK 1 



-.EXCEPTIONAL RETURN 
;ADDRESS 

REGAIN CONTROL HERE 
ON EXCEPTIONAL CON- 
DITION AND CONTINUE 



This mechanism returns control unconditionally 
to location SPECR upon the execution of an 
ERETR by subroutines B, C, D, or E. The 
stack pointer will be As original pointer and 
the caller's registers are unchanged but the 
registers returned to A are indeterminate. 
One case in which this feature could be 
used is in string processing, where special 
characters may require special processors or 
signal the termination of a set of processors. 

Following is a list summarizing the external declara- 
tions necessary to use the Save-Restore program: 



.EXTN SAVR, RETR 



EXTN ERETR 



.EXTD ERUSP, ERAD 



;USE OF THESE FEATURES 
;IS OPTIONAL 

USE OF THIS FEATURE IS 
OPTIONAL. HOWEVER, IF 
;USED, IT REQUIRES THE 
EXTERNAL DISPLACE- 
MENTS THAT FOLLOW 



MUST BE DECLARED AND 
INITIALIZED TO USE 
EXCEPTIONAL RETURN 



COMMAND TABLE BUILDER (CTB) PROGRAM 

This program reads a command line from the $TTI 
into a user- supplied core block and dissects the line 
into a table of string (byte) pointers and flag bit set- 
tings. Blank characters In the line are considered 
string separators. The table is the effective SOS 
equivalent of the RDOS COM. CM file (see 093-000075, 
Appendix D). The table is intended only for the SOS 
user employing the RDOS to SOS Interface Program, 
described in Chapter 1. 

The table produced by this program, the translate 
table used to derive the flag bit settings, and the 
input buffer for reading the command line must be 
supplied by the calling program. The SOS user 
stack (see Save-Restore Program) must also be 
supplied by the caller. 

The command line that is read may be continued by typing 
a SHIFT N (up arrow) character one position before the 
carriage return. The RUBOUT key (echoed as a back 
arrow) causes the preceding character to be deleted from 
the line. The current line may be deleted by typing SHIFT 
L (backslash). A facility to output a prompt message be- 
fore reading the command line also exists in the program. 

One command table entry is created for each unique 
string in the input line. Each of these strings may 
be modified by multiple alphabetic switches ( /a 
where a is a single letter) and/or one numeric- 
switch ( /n where n is a digit 0-9). The slash which 
designates the switch character may follow the string 
directly or be separated by one or more blanks. The 
same applies to succeeding switches modifying the 
same string. The switch character must directly fol- 
low the slash, however. If a blank follows a slash, the 
next character examined will be considered the start of 
a new string. Any characters which follow the switch 
character are ignored. These features are illustrated 
by the following equivalent argument strings: 

$PTR/2 /F /A 

$PTR/A/F/2 

$PTR/A /FINAL /2 

5PTR /ASCII /F /2 
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The layout of the command table built by the program is 
given in the SOS User Application Parameter Tape, 
090-000889. Eachunique string scanned in the command 
line causes a two-word entry to be added to the table. 
The first word at displacement CTBP from the entry 
pointer is a byte pointer to the string. The second word 
at displacement CTSW contains bit settings which cor- 
respond with switches that modified the string. 1 is 
correspondence is established in part by another user- 
supplied table. Bits 11 -15 of this word are reserved 



fni- Flu fc»ll. 



■wing use? 



Bits 12-15 



Bit 11 



A four-bit octal number derived 
from the numeric switch modify- 
ing the string. If no numeric 
switch is specified, no bits are 
set. Maximum value is octal i i. 

Set if one or more undefined 
switches modify the string. 



The user- supplied translate table (TRT) establishes the 
definition of bits 0-10 of this table. This allows eleven 
user specified alphabetic switches. The address of the 
translate table is one of the arguments passed to the 
program. The table occupies at most 11 locations 
which specify the bit position/alphabetic switch corres- 
pondence. The following examples illustrate the use of 
the table: 



TRT: 



"C 


,/C = BIT 


"E 


,/E = BIT 1 


"B 


/B = BIT 2 


"X 


/X = BIT 3 


"A 


/A = BIT 4 


"M 


/M=BIT 5 


"T 


/T = BIT 6 


"Z 


/Z = BIT 7 


"H 


/H = BIT 8 


"P 


/P = BIT 9 


"S 


/S = BIT 10 


-1 - : 


TERMINATES TRANSLATE TABLE 



The above example of a translate table defines eleven 
alphabetic switches - C, E, B, X, A, M, T, Z, H, P, 
and S - to map respectively to bits 0-10 of the switch 
word. All other alphabetic switches result in the set- 
ting of bit 1 1 of the switch word. 



TRT: "A 


/A = BIT 


"L 


/L= BIT1 


"B 


/B= BIT 2 


"N 


/N = BIT 3 


-1 


TERMINATES TABLE 
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COMMAND TABLE BUILDER (CTB) (Continued) 

rhc previous translate table defines tour alphabetic 
switches - A, L, B, and N - to map to bits 0-3 of the 
switch word. All other alphabetic switches result in 
the setting of bit 11 of the switch word. The utility of 
the table may be increased by inserting the following 
equivalences into the program: 



SWA = SW0 
SWL = SW1 



SWB 
SWN 



SW2 
SW3 





LDA 


2, .CT ; 




LDA 


1, MASK ; 


LOOK: 


LDA 


0, CTSW, 2 ; 




AND 


1, 0, SZR ; 




JMP 


OUT ; 




INC 


2.2 ; 




INC 


2,2 ; 




JMP 


LOOK 


OUT: 


: 




MASK; 


SWA + SWN ; 


.CT: 


CT 





Symbols SW0, SW1, SW2, and SW3 are defined in the 
SOS User Application Parameter Tape. 

The following sample sequence of code may then be 
executed to examine the flag bits in each table entry: 



AC2 •+ COMMAND TABLE 

AC1 = MASK WORD 

AC0 = SWITCH WORD 

SWITCH "A" OR "N" ON? 

YES 

NO 

LOOK AT NEXT ENTRY 



'A" AND "N" SWITCH BITS 
ADDRESS OF COMMAND 
TABLE 

The calling procedure necessary to invoke the program 
is the following: 

JSR ,CTB 

arg l 

arg2 

arg 3 

arg4 

arg5 

return location 

The arguments passed are the following: 

arg l The byte address of any prompt message 
to be typed on the $TTO. If this argu- 
ment is a -1, then no message is typed. 

arg_2 The byte address of the input buffer used 
to read the command line. 

arg_3 The maximum byte size of the input buf- 
fer. If this length is exceeded through 
use of continued input lines, the read is 
terminated and reissued beginning with 
the prompt message. 
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COMMAND TABLE BUILDER (CTB ) (Continued) 



The beginning address of the command 
table to be created by the program. 
The maximum size of this table is de- 
termined by the maximum input buffer 
length. The table may have at most 
one entry for every word in the input 
buffer. This is the case in which every 
other input character is a string 
separator. 

The beginning address of the translate 
table to be used to interpret the string 
switches. 



arg 5 



The arguments returned are: 

1. The new Command Table, formatted as in the 
above description. 

2. The Command Table entry count in ACO. 

Accumulators 1 and 2 are unchanged; accumulator 3 
contains USP. All channels will be closed. Channels 
and 1 are used to read and write the command line 
and must therefore be closed when the program is 
entered. The SOS user stack must have been supplied 
and initialized as shown in the preceding section. 

A sample program which calls the CTB program and 
repeats the call if less than three unique strings are 
input is coded in the next column. 



COMMAND TABLE BUILDER (CTB) (Continued) 

. EXTN .CTB ; . CTB MUST BE DECLARED 



LDA i, CN3 
START: JSR @CTB 
PRMPT*2 

IBUF*2 

300 

CT 

STRT 

SUBZ# 1, 0, SNC 

JMP START 

STA 0, TO, 3 



LOAD COMPARAND 
CALL CT BUILDER 
BYTE ADDRESS OF 
PROMPT MESSAGE 
BYTE ADDRESS OF INPUT 
BUFFER 

;MAXIMUM COMMAND 
LINE LENGTH 

COMMAND TABLE ADDRESS 
TRANSLATE TABLE ADDRESS 
;3 OR MORE TABLE ENTRIES? 
NO.. RE -PROMPT 
YES. SAVE COUNT IN STACK 



CN3: 


3 






CTB: 


.CTB 






PRMPT: 


.TXT /** 


<15>/ 




IBUF: 


.BLK 140 






CT: 


.BLK 140 






STRT: 


"A 




;ONLY 4 SWITCHES RECOG- 




"B 




;NIZED 




"C 








"D 








-1 
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Four utility, programs are included in SOS: 

SOS Text Editor 
SOS Extended Assembler 
SOS Library File Editor 
SOS SYSGEN 

For systems with at least one cassette or magr-tic tape 
drive, three additional utility programs are included in 
SOS: 



SOS Relocatable Loader 

SOS Command Line Inter^re*"* 3 ** 

Core Image Loader/Writer 

All except the SOS Text Editor and the Core Image 
Loader/Writer are supplied in both relocatable binary 
and absolute binary torms. The SOS Text Editor is 
supplied in relocatable binary form only, and the Core 
Image Loader/Writer is supplied in absolute binary form 
only. Relocatable binary forms must be configured with 
I/O support as described in Chapter 6, Configuring SOS 
Utility Programs. Absolute binary forms are precon- 
figured as described in Chapter 1. 

Details of operation of the SOS Text Editor, SOS Extended 
Assembler, SOS SYSGEN, and SOS Relocatable Loader 
are explained in Appendix A. Details of operation of the 
SOS Library File Editor are contained in the Library 
File Editor manual, 093-000074. Details of operation of 
the SOS Command Line Interpreter and Core Image 
Loader/Writer are explained later in this chapter. 

PAPER TAPE OPERATION 

SOS utility programs can be operated using the binary 
loader to load absolute binary paper tapes from the high- 
speed paper tape reader or the teletype paper tape 
reader. The procedures for loading programs in this 
manner are described in Section 2. 8 of "How to Use the 
Nova Computers. " 

MASTER CASSETTE OR MAGNETIC TAPE OPERATION 

Systems with one or more cassette or magnetic tape 
drives are provided with two special utility programs: a 
command line interpreter (CLI) and a core image loader/ 
writer. The core image loader/writer transfers core 
image files between core and either cassette or magne- 
tic tape. The CLI implements mnemonic loading of 
other utility programs into core from a master cassette 
or magnetic tape reel. In addition, the CLI performs a 
number of basic file maintenance tasks for the user. 



Master Cassette or Magnetic Tape Reel 

A master cassette or magnetic tape reel has the following 
format: 

File 0: Core Image Loader/Writer 

File 1: Command Line Interpreter (CLI) 

File 2: Text Editor 

File 3: Extended Assembler 

File 4: Extended Relocatable Loader 

File 5: Library File Editor 

File 6: SYSGEN 

To be used as a master, this cassette or magnetic tape 
reel must be mounted on cassette drive (CTO) or mag- 
netic drive (MT0), respectively. Each utility program 
on the master reel must be in executable core image 
form. Procedures for generating a master reel are 
discussed in Chapter 6, Configuring SOS Utility Programs. 

CORE IMAGE LOADER/WRITER 

The core image loader/writer is a utility program that 
performs two functions: it loads core image files from 
cassette or magnetic tape into core and produces core 
image files on cassette or magnetic tape from the con- 
tents of core. There are 2 versions of the core image 
loader/writer --one for use with cassette drives and an- 
other for use with magnetic tape drives. The cassette 
version works only with cassettes and the magnetic tape 
version works only with magnetic tape. Both versions when 
loaded occupy the last 400s locations in core. 

Bootstrap Procedure 

Xhp CClTf* imflffP lnatif*T /writer nan rto hnAtctran Iab<1a<) 

from file of the master cassette or magnetic tape reel. 
The master reel must be loaded on cassette or magnetic 
tape unit and must be rewound manually. This can be 
done by pressing the REWIND button on the drive unit. 

For machines without the Program Load option, deposit 
060134 (for cassette units) or 060122 (for magnetic tape 
units) into location 376g, and deposit 000377 into loca- 
tion 377g. Press the console switches for RESET and 
then START. 

For machines with the Program Load option, set the 
data switches on the console to 100034 (for cassette 
units) or 100022 (for magnetic tape units), press RESET 
and then PROGRAM LOAD. 

The core image loader/writer is read into page zero 
initially and then relocates itself to the high end of 
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Bootstrap Procedure (Continued) 

memory. At the end of the relocation process, the 
loader outputs a prompt (#) on the teletype. This prompt 
indicates that the core image loader is ready to accept 
a command. Whenever the core image loader/writer 
is resident in core, the core image loader may be re- 
started by setting the data switches to the address of 
the last location in memory, pressing RESET, and then 
pressing START. The core image writer can be started 
by setting the data switches to the address of the next 
to last location in core, pressing RESET and then 
pressing START. 

Core Image Loader Operation 

Having issued the # prompt on the teletype, the core 
image loader waits for an operator response of a device 
number (0-7) and a file number (0-99) separated by a 
colon. Device need not be specified. For example: 



#2:7/ 



UJ 



(unit 2, file 7) 
(unit 0, file 4) 



The indicated cassette or magnetic tape file is loaded 
from the specified device into memory starting at ad- 
dress 0. If data switch on the console is set (up), the 
loader will halt after loading is complete. If switch 
is reset (down), the loader will transfer control to the 
address at location 405g at the end of the loading pro- 
cess, unless this location contains -1. If location 405g 
contains -1, the loader will simply halt. 

If the core image loader encounters a non-recoverable 
error while trying to load a core image file, it will 
type 

*ERR 

and halt with the cassette or magnetic tape status word 
in ACO. The following list describes the error condi- 
tions assigned to each bit in the status word. 

Bit Meaning 

1 Data late (perhaps due to a long indi- 

rect access chain or a faster device 
preempting the channel. ) 

3 Illegal command 

5 Lateral parity error in a word 

6 Addressed tape is beyond the EOT 
marker 

8 Addressed tape is at load point 

10 Bad tape (e.g., data is found in an 

interrecord gap) 

13 Unit is write locked 

14 Odd number of bytes detected in a read 
or write attempt 



Core Image Loader Operation (Continued) 

If rewinding and substituting a fresh cassette or mag- 
netic tape does not cure an error condition, a hardware 
malfunction is indicated; run the appropriate diagnostic 
program. 

Core Image Writer Operation 

The core image writer operates in a manner similar to 
that of the core image loader. When the core image 
writer is started it outputs a # prompt and waits for 
specification of a device number and a file number 
separated by a colon. Unit need not be specified. 
After the file has been specified, the core image writer 
will request specification of the upper core address 
(NMAX) to be written onto tape. It doeB this by typing: 

NMAX: 

on the teletype. The operator must then respond with 
the highest core address (in octal) whose contents he 
wants written into the core image cassette or magnetic 
tape file. Upon detection of a non-recoverable error, 
the core image writer proceeds in the same way as the 
core image loader. 

nAUWVTl I t»i»? rmTTDDDCTUD /HI T\ 

tUMMfllNU J-.11NC, ir< lmniiv-i- ** ~^ \~-"/ 

The Command Line Interpreter (CLI) is a utility pro- 
gram which performs certain file maintenance chores 
for the user and implements mnemonic loading of other 
utility programs from a master cassette or magnetic 
tape. The CLI accepts commands typed by the operator 
on the teletype. When it is ready to receive a command, 
the CLI types on the teletype a prompt consisting of R 
followed by a carriage return. 

In order to fully utilize the CLI, the core image loader/ 
writer should be resident in core, and a master cassette 
or magnetic tape should be loaded on cassette drive 
(CT0) or magnetic tape drive (MT0). A master cas- 
sette or magnetic tape has the following format: 

File 0: Core image loader/writer (bootstrappable) 

File 1: Command Line Interpreter (CLI) 

File 2: Text Editor 

File 3: Extended Assembler 

File 4: Extended Relocatable Loader 

File 5: Library File Editor 

File 6: SYSGEN 

The CLI can be loaded from the master cassette or mag- 
netic tape reel using the core image loader/writer. 
Many of the commands the CLI accepts result in the CLI 
being overwritten in core. After these commands, 
return can be made to the CLI only by loading it again. 
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COMMAND LINE INTERPRETER (CLI) (Continued) 

The following are descriptions of the commands 
accepted by the C LI: 

Load the Assembler 

Format: ASM 

This command causes file 3 from the master cassette 
unit (CTO) or magnetic tape unit (MTO) to be loaded. 
The effect is the same as for a 0:3 command to the core 
image loader. The CL! is overwritten in core b" the 
extended assembler. If data switch on the console is 
reset (down) the assembler will type the prompt ASM 
on the teletype when the loading is complete. 

Load an Absolute Binary Paper jape 



Format: 



BLDR $PTR or 
BLDR $TTR 



This command will load an absolute binary tape with 
the binary block loader (contained in the CLI), using 
either the high-speed paper tape reader ($PTR) or the 
teletypewriter reader ($TTR). The loading will over- 
write both the core image loader/writer and the CLI 
in core. 

Load a Cassette File 



Format: CTx:yy_ 

where: x is the cassette drive num- 
ber (0-7) and 

yy is the file number (0-99) 
to be loaded from that drive. 

Core image file y_y_ on cassette drive x is loaded into 
core, overwriting the CLI. If no file yy_ exists on 
cassette drive x the error message FILE NON-EXIST- 
ENT is printed on the teletype. In systems operating 
from magnetic tape (the magnetic tape core image 
loader/writer is used) this command is not valid and 
results in the error message NON-EXISTENT FILE. 

Load the Text Editor 



Format: 



EDIT 



File 2 from the master cassette unit (CTO) or magnetic 
tape unit (MTO) is loaded into core. The effect is the 
same as for a 0:2 command to the core image loader. 
The CLI is overwritten in core by the text editor. If 
data switch on the console is reset (down) the text 
editor will type the prompt * on the teletype when 
loading is complete. 
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Initialize Cassette or Magnetic Tape 

Format: INIT devicename 

where: devicename is one of CTO, 
CT1,...CT7, or MTO, 
MT1....MT7. 

The cassette or magnetic tape unit specified is rewound. 
If there is no such unit in the system, the error mes- 
sage ILLEGAL FILE NAME will be printed on the 
teletype. 

Load the Library File Editor 

Format: LFE 

File b from the master cassette unit (CTO) or magnetic 
tape unit (MTO) is loaded into core. The effect is the 
same as for a 0:5 command to the core image loader. 
The CLI is overwritten in core by the library file 
editor. If data switch on the console is reset (down) 
the library file editor will type the prompt LFE on the 
teletype when loading is complete. 

Make a Save File 

Format: MKSAVE absolute -binary -filename output 

filename 

Input from file absolute -binary -filename is converted to 
a core image (save) file. This core image file be- 
comes file output filename. Possible error messages 
are: 

NOT ENOUGH ARGUMENTS 
ILLEGAL FILE NAME 
ILLEGAL COMMAND FOR DEVICE 
DEVICE IS READ PROTECTED 
FILE NON-EXISTENT 
CHECKSUM ERROR 
PHASE ERROR 

Load a Magnetic Tape File 



Format: 



MTx:yy_ 



where: x is the magnetic tape drive 
number (0-7) and 
yy is the file number (0-99) 
to be loaded from that 
drive. 

Core image file y_y_ on magnetic tape drive x is loaded 
into core, overwriting the CLI. If no file y_y_ exists on 
magnetic tape drive x, the error message NON- 
EXISTENT FILE is printed on the teletype. In systems 
operating from cassette (the cassette core image loader/ 
writer is used), this command is not valid and results 
in the error message NON-EXISTENT FILE. 
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Release Cassette or Magnetic Tape 

Format: RELEASE devlcename 

where: devicename is one of CTO, 

CT1 CT7, orMTO, MT1, 

...,MT7 

The cassette or magnetic tape unit specified is rewound. 
If there is no such unit in the system, the error mes- 
sage ILLEGAL FILE NAME will be printed on the 
teletype. 

Load the Relocatable Loader 



Format: RLDR 



File 4 from the master cassette unit (CTO) or magnetic 
tape unit (MTO) is loaded into core. The effect is the 
same as for a 0:4 command to the core image loader. 
The CLI is overwritten in core by the relocatable 
loader. If data switch on the console is reset (down) 
the relocatable loader will type the prompt RLDR on the 
teletype when it has been loaded. 

Load SYSGEN 

Format: SYSG 

File 6 from the master cassette unit (CTO) or magnetic 
tape unit (MTO) is loaded into core. The effect is the 
same as for a 0:6 command to the core image loader. 
The CLI is overwritten in core by SYSGEN. If data 
switch on the console is reset (down) SYSGEN will 
type the prompt SYSG on the teletype when loading is 
complete. 

Transfer a File 

Format: XFER source filename destination 

filename 

XFER/A source filename destination 

filename 

This command causes file source filename to be trans- 
ferred to file jdesUnationJUejiame. Transfer is made in 
binary mode unless the switch /A is given. When switch 
/A is given, the source file data is interpreted as even 
parity ASCII. Special action is taken at the destination 
file depending upon the nature of the destination device. 
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The relocatable binary versions of SOS utility programs 
can be used to produce executable versions of these pro- 
grams configured with arbitrary I/O support. This al- 
lows the user to produce executable utility programs 
with the necessary I/O support for the devices in his 
particular system, without wasting core space for device 
drivers that never are used. 

The process of configuring a utility program can be div- 
ided into two main tasks: producing a trigger which 
specifies the desired I/O support, and performing a 
reiocatahlp innti nf rtiA ti>i<m>r *.u« «_.. »-*^ «^%f 

libraries, and the relocatable binary form of the utilitv 
program. 

PRODUCING A TRIGGER (FOR ALL SOS SYSTEMS) 

Triggers are produced by the SYSGEN program. The 
SYSGEN program accepts from the teletype a command 
line containing device driver entry and outputs a file 
(the trigger) containing external normal references to the 
named device drivers. These external normal refer- 
ences cause the named device drivers to be loaded from 
SOS libraries when the trigger precedes those libraries 
as input to the relocatable loader. 

The first step in producing a trigger is to load and start 
the SYSGEN program. This can be done using the binary 
loader to load an absolute binary SYSGEN paper tape 
(091-000070, 091-000071, or 091-000074). SYSGEN can 
also be loaded from cassette or magnetic tape using the 
core image loader/writer. 

When the SYSGEN program is started, it outputs to the 
teletype the prompt 

SYSG 

and waits for the user to type a command line. The 
SYSGEN command line has the following format: 

(SYSG) driver ! . . . driyer n . DSI [ . CTB] 

output-device /O [ trigger-name /T] 

where: driver ^ is a device driver entry symbol. 

. DSI is the RDOS to SOS interface program and 
must appear in every SYSGEN command line. 

. CTB is the optional command table builder. The 
. CTB must be specified only for triggers to 
be used in configuring the assembler, re- 
locatable loader, the CLI, or the SYSGEN 
program itself. 

output -device is the name of the device to which 
the user wishes the trigger to be output. 
This device name must be followed by the 
/O switch. 

trigger- name is the optional name of the trigger. 

~ If this name is omitted, by default the trigger 
will be named . MAIN. If the name is present. 
It must be followed by the /T switch. 
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PRODUCING A TRIGGER (Continued) • 


Driver Entry Symbol 


Device 


.CDRD 
.CTAD 
.CTUl 


card reader 
cassette unit only 
cassette units and 1 



CTU7 

FTPD 

PTRD 

LPTD 

MTAD 

MTU1 



MTU7 
PLTD 
STTY 



cassette units through 7 
high-speed paper tape punch 
high-speed paper tape reader 
line printer 

magnetic tape unit only 
magnetic tape units and 1 



magnetic tape units through 7 

plotter 

teletype printer and keyboard 

only 



If . STTY is not specified, a full teletype driver (including 
teletype paper tape reader and purch) will be loaded by 
default. 

For example, to produce a trigger on paper tape for 
the assembler to provide support for a full teletype, 
high-speed reader and punch and cassette units and 1, 
the following SYSGEN command line could be typed: 

(SYSG) . PTRD . PTPD . CTUl . DSI . CTB $PTP/0 

The trigger produced will have the title . MAIN since no 
trigger name was specified. The trigger will be output 
by the high-speed paper tape punch. 

After the trigger has been output, the SYSGEN program 
will again type its prompt (SYSG) and wait for 
another command. If more than one utility program is 
to be configured requiring different triggers, it is most 
convenient to generate all the necessary triggers before 
overwriting the SYSGEN program in core. 

A discussion of the SYSGEN program, including its 
associated error messages, is included in Appendix A. 

CONFIGURATION PROCEDURE (FOR PAPER TAPE 
SYSTEMS) 

The following is a step by step description of a procedure 
for configuring any SOS utility program (except the 
assembler) using only paper tapes as input files. The 
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CONFIGURATION PROCEDURE (FOR PAPER TAPE 

SYSTEM) (Continued) 

end product is an absolute binary paper tape. Before 
starting this procedure, the trigger to be used should be 
generated on paper tape. Each typed command in this 
procedure must be terminated by a carriage return. 

1. Using the binary loader, load the extended relocat- 
able loader (tape 091-000038). 

2. Mount the trigger in the teletype reader and type 1, 
or in the high-speed paper tape reader and type 2. 

3. Mount the SOS library (099-000010) in the teletype 
reader and type 1, or in the high-speed paper tape 
reader and type 2. If the trigger specifies support for 
cassette or magnetic tape drives, perform this process 
first for the SOS cassette library (099-000041) or the 
SOS magnetic tape library (099-000042), and then the 
SOS library. 

4. Mount the relocatable binary version of the program 
to be configured in the teletype reader and type 1, or 

in the high-speed paper tape reader and type 2. 

5. Type 5 and note the value of NMAX output by the 
relocatable loader on the teletype; this number will be 
used in Step 12. 

6. Mount the relocatable binary punch program (089- 
000080) on the teletype reader and type 1, or on the 
high-speed paper tape reader and type 2. 

7. Type 6 and note the value of RBFP output by the 
relocatable loader on the teletype; this number will be 
used in Step 10. 

8. Type 8 to terminate the loading process. 

9. Examine the contents of location 405 8 ; note this 
value for use in Step 13. 

10. Enter RBFP (from Step 7) into the data switches 
on the computer console, press RESET and then press 
START. 

11. Type OH for output on the teletype punch or 1H 
for output on the high-speed paper tape punch. 

12. Type l.nmaxP where nmax is the value of NMAX 
noted in Step 5. 

13. Type cE where c is the value (in octal) of the con- 
tents of location 4058 noted in Step 9. 



CONFIGURING THE ASSEMBLER (FOR PAPER TAPE 

SYSTEMS) 

The following is the procedure for configuring the SOS 
extended assembler. It is similar to the preceding pro- 
cedure for the other SOS utility programs. 

1. Using the binary loader, load the extended relocat- 
able loader (tape 091-000038). 

2. Mount the trigger in the teletype reader and type 1, 
or in the high-speed paper tape reader and type 2. 

3. Mount the SOS library (099-000010) in the teletype 
reader and type 1, or in the high-speed paper tape 
reader and type 2. If the trigger specifies support for 
cassette or magnetic tape drives, perform this process 
first for the SOS cassette library (099-000041) or the 
SOS magnetic tape library (099-000042), respectively, 
and then mount the SOS library. 

4. Mount the relocatable binary version of the SOS 
extended assembler (089-000106) in the teletype reader 
and type 1, or in the high-speed paper tape reader and 
type 2. 

5. Enter 016500 8 in the data switches on the computer 
console and type 3. 

6. Mount the relocatable binary punch program (089- 
000080) on the teletype reader and type 1, or on the 
high-speed paper tape reader and type 2. 

7. Type 6 and note the value of RBFP output by the re- 
locatable loader on the teletype; this number will be 
used in Step 13. 

8. Type 8 to terminate the loading process. 

9. Press CONTINUE on the computer console to start 
the assembler. 

10. Mount the extended assembler command definitions 
tape (090-000890) in the teletype reader and type $TTR, 
or in the high- speed paper tape reader and type $PTR. 

11. When the assembler halts, examine AC0 and note its 
contents (NMAX); this value will be used in step 15. 

12. Examine the contents of location 405g; note this 
value for use in Step 16. 

13. Enter RBFP (from step 7) into the data switches on 
the computer console, press RESET, and then press 
START. 
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14. Type OH for output on the teletype punch or 1H 
for output on the high-speed paper tape punch. 

15. Type 1, nmaxP where nmax is the value of NMAX 
noted in step 11. ~ 

16. Type cE where c is the value (in octal) of the 
contents of location 405 8 noted in Step 12. 

PRODUCING A MASTER REKI. 

The following is a step by step description of a pro- 
cedure for configuring SOS utility programs and at the 
same time producing a master cassette or magnetic 
tape reel. The assumption is made that only one 
cassette or magnetic tape drive is available and that 
the programs used are available only on paper tapes. 
Two cassette and magnetic tape reels are required for 
this procedure; when mounted, cassette reels should 
have their file protect tabs in place and magnetic tapes 
reels should contain a write permit ring so that files 
may be written on them. Before starting this pro- 
cedure, the triggers to be used should have been gen- 
erated on paper tapes. Each typed command in this 
procedure must be terminated by a carriage return. 

1. Using the binary loader, load and start the absolute 
binary version of the command line interpreter (091- 
000072 for cassette; 091-000075 for magnetic tope). 
When started the CLI will type the prompt R on the 
teletype. 

2. Mount the cassette or magnetic tape reel that is not 
to become the master reel on unit 0. 

3. Mount the absolute binary version of the SOS re- 
locatable loader (091-000073) for cassette: 091-0000^6 
for magnetic tape) in the high-speed paper tape reader 
(or the teletype reader) and type the command line: 

MKSAVE $PTR CTO.-O (for cassette) 

MKSAVE $PTR MT0:0 (for magnetic tape) 

If the teletype reader is used, substitute $TTR for $PTR. 

4. When the CLI again types the R prompt, remove the 
first reel and mount the master reel on unit 0. 

5. Mount the core image loader /writer (091-000067 for 
cassette; 091-000068 for magnetic tape) in the high- 
speed paper tape reader (or teletype reader) and type the 
command line: 
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PRODUCING A MASTER REEL (Continued) 

5. (Continued) 

MKSAVE $PTR CTO.-O (for cassette) 
MKSAVE $PTR MT0:0 (for magnetic tape) 
If the teletype reader is used, substitute $TTR for $PTR. 

6. Rewind the master reel by pressing REWIND on 
the drive unit and bootstrap the core image loader. 

The DOOtStraD nrnress was pvnlninori in Chara-or s. 

7. After the core image loader has output its prompt 
(#), remove the master reel and mount the other reel 
on unit 0. 

8. Set data switch on the computer console to the 
zero position (down) and type 0. The core image 
loader will load the relocatable loader into core. 

9. After the relocatable loader has typed its prompt 
(RLDR) on the teletype, mount the master reel on 
unit 0. 

10. Type the following command line to the relocat- 
able loader: 

CT0:1/S $PTR/4 (for cassette) 

MT0:1/S $PTR/4 (for magnetic tope) 

If the teletype reader is to be used, substitute $TTR for 
$PTR. As the relocatable loader requests them, mount 
the following paper tapes in order: 

1. The trigger to be used for the command line 
interpreter. 

2. The SOS cassette library (099-000041) for 
cassette or the SOS magnetic tape library 
(099-000042) for magnetic tape. 

3. The SOS library (099-000010). 

4. The relocatable binary version of the command 
line interpreter (089-000121). 

The loader will produce a core image file of the CLI 
on the master cassette and will type OK when finished. 

11. Restart the core image loader by setting the 
address of the last location in core into the data switches 
on the computer console, pressing RESET, and then 
pressing START. Repeats Steps 7, 8, and 9. Repeat 
Step 10 making the following substitutions: 
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PRODUCING A MASTER REEL (Continued) 

11. (Continued) 

1. CT0:2 or MT0:2 instead of CT0:1 or MT0:1 
respectively, in the relocatable loader command 
line. 

2. The trigger for the SOS text editor instead 
of the trigger for the CLI. 

3. The relocatable binary version of the SOS 
text editor (089-000104) instead of that for the 
CLI. 

12. Restart the core image loader. Repeat steps 
7, 8, and 9. Repeat Step 10 making the following 
substitutions: 

1. CT0:3 or MT0:3 instead of CT0:1 or MT0:l 
respectively, in the relocatable loader command 

line. 

2. The trigger for Jhe SOS extended assembler 
instead of the trigger for the CLI. 

3. The relocatable binary version of the SOS 
extended assembler (089-000106) instead of that 
for the CLI. 

13.- Press CONTINUE on the computer console to 
start the assembler. 

14. Mount the extended assembler command definitions 
tape (090-000890) in the high-speed paper tape 
reader (or teletype reader). After the assembler has 
typed its prompt (ASM), type the command line: 

$PTR 

If the teletype reader is used, substitute $TTR for 
$PTR. The assembler will perform a one pass assem- 
bly of the command definitions and will then halt. 

15. Examine the contents of AC0 and note them for 
use in Step 16. 

16 Start the core image writer by setting the address 
of the next to last location in core into the data switches 
on the computer console, pressing RESET, and then 
pressing START. After the core image writer types its 
prompt (#), type 3. The core image writer will type 
NMAX:. Respond by typing (in octal) the value noted in 
Step 15. The core image writer will produce a core 
image file on the master reel and type Its prompt 
(#) when finished. 



PRODUCING A MASTER REEL (Continued) 

17. Restart the core image loader. Repeat Steps 
7, 8, and 9. Repeat Step 10 making the following 
substitutions: 

1. CT0:4 or MT0:4 instead of CT0:1 or MT0 :1 
respectively, in the relocatable loader command 

line. 

2. The trigger for the relocatable loader instead 

of the trigger for the CLI. 

3 The relocatable binary version of the SOS re- 
locatable loader (089-000120) instead of that for the 
CLI. 

18. Restart the core image loader. Repeat Steps ", 
8, and 9. Repeat Step 10 making the following 
substitutions: 

1 CT0:5 or MT0:5 instead of CT0:1 or MT0:1 
respectively in the relocatable loader command line. 
2. The trigger for the library file editor instead 
of the trigger for the CLI. 

3 The relocatable binary version of the library 
file editor (089-000081) instead of that for the CLI. 

19 Restart the core image loader. Repeat Steps 
7, 8, and 9. Repeat Step 10 making the following 
substitutions: 

1 CT0-6 or MT0:6 instead of CT0:1 or MT0:1 
respectively in the relocatable loader command line. 

2 . The trigger for SYSGEN instead of the trigger 

3. The relocatable binary version of SOS SYSGEN 
(089-000122) instead of that for the CLI. 
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This appendix provides details of the operation of four 
SOS utility programs: SOS extended assembler, SOS 
relocatable ioader, SOS text editor, and SOS SYSGEN. 

The conventions used in defining command line formats 
are: 

All upper case letters represent valid command 
line elements. 

Items in a command line printed in lower-case 
indicate either command information or device 
names which must be supplied. 

Elements enclosed in brackets ( [ ] ) are optional. 
Stacked items indicate alternate choices. 

The ellipsis (...) is used to indicate that "receding 
command information may be repeated if desired. 

Command names enclosed in parentheses are 
prompts output by system programs. These prompts 
are not significant command line elements, but 
merely indicate that the system program is loaded 
and ready to accept command line input. 

ASSEMBLER 

Format: (ASM) file name ] ... 

(ASM) 1 file name t ... 

(ASM) 2 file name ] . . . 

Purpose : To assemble one or more ASCII source files. 
Output may be an absolute or relocatable binary file, 
with an optional listing file. Input files are assembled 
in the order specified in the command line. A cassette 
or magnetic tape unit may not be used for both input and 
output, nor may it be used for more than one output file. 
A cassette or magnetic tape unit may be used for more 
than one input file. 

In the above formats, 0, 1, and 2 are keys describing 
the number of passes required. Global switches listed 
below modify the key in a given command line. Action 
taken by the assembler depends upon the key specified in 
the command line: 

- Perform pass one on the specified input source 

file(s), then halt with the highest symbol table 
address (SST) in ACO. Normally the source file 
is a Command Definition tape. The user may 
then invoke the core image writer to preserve 
a copy of this assembler on any cassette file. 

1 - Perform pass one and pass two on the specified 

input files, producing the specified binary and 
listing files. At the completion of pass two, the 
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ASSEMBLER (Continued) 

Purpose (Continued) 

assembler outputs a new prompt, ASM, and 
awaits a new command line. 

2 - Perform pass two only on the specified input 

filec n ^~l.. n t--H 'f > M J U„*i. 

..**«*,? j/4.wuLiwiiig uic opc^iiicu kuimiy emu .liming 

files. The symbol table used for this pass is 
that produced by the most recently executed 
pass one assembly. At the completion of this 
pass. Die assembler outputs a new prompt. 
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Switches 



Global: 



/E suppress assembly error messages normally 
output to the $TTO. 

/T suppress the listing of the symbolteble. 

/U include local (i. e. , user) symbols in the binary 
output file. 



Local : 
/B 

/L 

/N 
/P 



/S 

/a 

Errors: 



relocatable or absolute binary file is output on 
the given device. 

any output device to which the_listing is directed. 

any input file which is not to be listed on pass 2. 

pause before accepting a file from a device. The 
message: 

PAUSE - NEXT FILE, devicename 

is output by the assembler which waits until any 
key is struck on the teletypewriter console. 

skip this source file during pass two. 

repeat the given input source file n times, where 
n is a digit from 2 to 9. 



NO. END (No . END statement in any source file. ) 

I/O ERROR nn nn is an error code. The following codes 
and their meanings are possible: 

1 ILLEGAL FILE NAME 
7 ATTEMPT TO READ A READ- 
PROTECTED FILE. 

10 WRITE -PROTECTED FILE 

12 NON-EXISTENT FILE 
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ASSEMBLER (Continued) 

Examples: 

1 CT1:0/B $LPT/LCT0:0/SCT0:1 CT0:2/N J 

causes a two-pass assembly to be executed 
using cassette files 0, 1, and 2 on unit as 
input files. A binary file is produced on unit 
1, file 0, and a listing file is printed on the 
line printer. On pass 2, input file CT0:0 is 
skipped, and input file CT0:2 is not listed. 

2/U CT0:13 CT0:14 CT0:18 CT0:8 CT1:1/B CT2:0/L J 

causes the second pass of an assembly to be 
executed using input files 13, 14, 18 and 8 (in 
that order) on cassette unit 0. The binary, 
containing user symbols, is produced on file 
1 of cassette unit 1 , and the listing is produced 
on file of cassette unit 2. 

1/E CT0:16 CT0:17 CT1:0 CT1:1 $LPT/L J 

causes a two-pass assembly to be executed on 
Input files CT0:16, CT0:17, CT1:0, and CT1:1 
with a listing printed on the line printer. Error 
messages normally output to the $TTO are 
suppressed, and no binary file is produced. 

1 CT0:0/S CT0:0/P CT1:1/B J 

causes a two-pass assembly to be performed on 
two files, both of which will be read from unit 
0. The first file is a parameter list which will 
be read during the first pass only. After this 
parameter list is read, the pause message is 
output, and a new file is placed in cassette unit 
0. The first file of this new reel is scanned for 
both pass 1 and pass 2 to complete the assembly. 
File 1 of unit 1 receives the binary output; no 
listing is produced. 



RELOCATABLE LOADER 



Format: 



(RLDR) file na.me \ 



Purpose: To produce from relocatable binary files 
an executable core-resident file and a core-image (or 
save) file. Both files start at address zero. The symbol 
table is included in these files only if the debugger has 
been loaded, and then the table always follows the pro- 
gram immediately. 

The debugger provided for cassette and magnetic tape 
systems Is Extended Debug III. This debugger is found 
on relocatable binary tape 089-000073 . 



RELOCATABLE LOADER (Continued) 

Purpose : (Continued) 

The loading of user ZREL begins at location 50 8 , and 
user NREL loading starts at location 440g. Locations 
400-437 contain the User Status Table. Location 405 8 
contains the starting address of the loaded program. 

The maximum size of each loaded program cannot 
exceed the maximum core address less 1325g. The 
relocatable loader will type symbol tables for programs 
whose size exceeds that maximum value, yet the loading 
process will not be completed for such programs. 

Upon completion of each successful load, the message 
"OK" is output and the system halts with the loaded 
program in core. 

Switches 



Local: 



/A causes a listing of the symbol table with symbols 
ordered alphabetically. (The local switch /L 
must also be given to define an output listing 
device. ) 

/L causes a listing of the symbol table on the output 
file or device whose name precedes the switch. 
Symbols in the table will be ordered numerically 
by symbol value. 

/N set current NMAX (the starting load address) 
forcing the file name following the switch to the 
absolute address immediately preceding this 
switch. 

/P pause before opening this file. The message: 

PAUSE -NEXT FILE, devicename is output by the 
loader which waits until any key is struck on the 
teletypewriter console. 

/S output the save file to the device (either 

cassette or magnetic tape unit) whose name 
precedes this switch. 

/U load user symbols appearing within the file 
whose name precedes this switch. 

/n load the preceding file n times, where n is a 
digit from 2 to 9. 



Errors: 

NO INPUT FILE SPECIFIED. 

NO SAVE FILE SPECIFIED (i.e., no core image output 
device has been specified with a /S switch. ) 

SAVE FILE IS READ/WRITE PROTECTED (The save 

file device must permit both reading and writing: 
only cassette and magnetic tape units are per- 
mitted as save file devices. ) 
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I/O ERROR nn (nn Is an error code). The following 
codes and their meanings ate possible: 

1 - ILLEGAL FILE NAME 
7 - ATTEMPT TO READ A READ-PRO- 
TECTED FILE 

10 - WRITE -PROTECTED FILE 

12 - NON-EXISTENT FILE 

Example : 

The command line : 

JTTO/L/A CT2:0/S $PTR CT1:6 16500/N CT1:0 J 

causes the relocatable loader to load programs 
into core from the paper tape reader ($PTR), 
file 6 on cassette drive 1 (CT1:6), and file 
on cassette drive 1 (CT1:0). The program 
from CT1:0 is loaded starting at address 16500s 
(16500/N). A core image file containing the 
loaded programs is written to file of cassette 
unit 2 (CT2:0/S). An alphabetically ordered 
symbol table is output on the teletype printer 
($TTO/L/A). 



SYMBOLIC TEXT EDITOR 



Format: 



Puroose: 



EDIT 



Tn lruiri fhp sumhAlir tavt oHltAt- Kir man**** 

of the CLI core image load command. The operation 
of the text editor is as described for the DOS editor 
in the Nova Text Editor Manual, 093-000018, except 
for the following. 

When the H command is issued, control returns to the 
beginning of the editor program just as though the user 
had depressed RESET, then START with 377 in the 
console data switches. 

As with the RDOS editor, CTRL A interrupts the activity 
of the editor. Also as with the RDOS editor, all output 
files must be closed with the GC_ command. Execution 
of the P or E commands does not insure that the final 
input page will be written onto the output file. 

Switches : 



Not applicable. 
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SYMBOLIC TEXT EDITOR (Continued) 

Errors : 

See errors given for the Core Image Loader command 
and in the Text Editor manual. 

Example: 

After loading and activating the text editor, input and 
output files must be assigned. For example: 

GRCT2:3$GWCT1:3$$ 

causes a source file to be read from file 2 of cassette 
unit 3, and an output file to be written as file 3 of 
unit 1. 

SYSGEN 



Format: (SYSG) driver ! . . . driver,, .DSI [.CTB] 

output-device /O [ trigger-name/ T ] J 

Purpose: The SYSGEN program generates triggers 
for use in configuring SOS utility programs. Each 
driver in the command line is an entry symbol for a 
program in one of the SOS libraries. For each of 
these entry symbols included in the command line, an 
external normal reference to the program is Included 
in the trigger. The trigger is entirely made up of 
these external normal references, including external 
normal references for . DSI and . CTB. (if specified). 



JW11U1CD. 



/O 

/T 

Errors: 



the preceding specifies the output device 

the preceding is to be assigned as the title 
of the trigger 



NOT ENOUGH ARGUMENTS (At least two are needed. ) 
OUTPUT FILE WRITE PROTECTED, FILE: filename 
NO OUTPUTFILE SPECIFIED 
ILLEGAL SYMBOL NAME: symbolname (Invalid 

character in command line. ) 
FILE DOES NOT EXIST, FILE: filename 
UNEXPECTED SYSTEM ERROR (Computer halts with 

the system error code in AC2). 

Example: 

. FTRD . PTPD . MTU4 . STTY . DSI MT1.-3/0 HORSE/T J 
would cause the SYSGEN program to output a 
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SYSGEN (Continued) 

Example : (Continued) 

trigger named HORSE containing external 
normal references to the driver routines for 
the high-speed paper tape reader, high-speed 
paper tape punch, magnetic tape unit 4, and 
teletype keyboard and printer, and to the 
RDOS to SOS interface program (. DSI). 
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This appendix is intended to ease the task of adding a 
special device driver to the SOS library. There are 
really two levels of SOS compatibility available to the 
user who is incorporating additional devices: 

1. A level that permits servicing of an inter- 
rupt from one or more special devices, 
while selectively enabling interrupts from 
other devices. 

2. A level that permits complete control of the 
device via standard SOS commands. 

The complexity of the required user program increases 
with the ievel. Level i requires a Device Control 
Table (DCT) for each device and a Device Priority 
Table. Level 2 requires a DCT, a Device Priority 
Table, and a Channel -Number-to-Device Map. All of 
these tables, as well as the associated driver code, 
may be assembled in one- relocatable binary program. 
This program may then be included in the relocatable 
load module along with the SOS library. The SOS 
Parameters and the RDOS User Parameters may be in- 
cluded in the assembly to assure the proper definition 
of the required tables. 

The critical requirements for these levels are: 

Level 1 : Provide a means of clearing the device 
on system initializations and resets, 
and provide interrupt save storage 
compatible with the SOS scheme. 

Level 2 : In additon to the requirements for 
Level 1, provide a SOS Channel- 
Number-to-Device Control Table link 
and include the appropriate subset of 
I/O Dispatch routines: open, close, 
line, and sequential. 

If the tables are correctly defined in the user program, 
the SOS MAIN program will perform these critical 
functions, using the supplied information. 

No source level changes to the SOS library programs 
are necessary. The links to the user supplied tables 
currently exist in the SOS MAIN program in the form 
of unresolved external declarations, if these unresolved 
externals become resolved in the relocatable load mo- 
dule, then SOS assumes the "presence of an additional 
device or devices. The user must be careful, there- 
fore, not to resolve these externals inadvertently with 
his own global symbols. 

The remainder of this appendix describes the mecha- 
nisms that may be used to achieve Level 1 or Level 2 
SOS compatibility with optional devices. 



DEVICE CONTROL TABLE (DCT) 

Each SOS device requires a control table. Although 
some elements of the table may not be used by an added 
driver, the table must be defined exactly as in the fol- 
lowing description, so that the critical elements reside 
at the correct displacements. This table requires 33 
octal locations (displacements 0-32 from the DCT layout 
description in the SOS Parameter Tape). These dis- 
placements and their meanings are as follows: 



Equiva- 
lence Displacement 

DCTCD 



Meaning 

The octal device code. Must 
be assembled into the table. 

DCTMS The mask of all lower priority 

devices, including this device. 
This mask is used to disable in- 
terrupts from all lower priority 
devices while processing an in- 
terrupt from this device. This 
mask should reflect the priori- 
ties established by the Device 
Priority Table (page B-3). The 
mask' bits are defined in the SOS 
parameter tapes, and must be 
assembled into the table. 

DCTCH The active device characteristics 

from the DOS User Parameter 
Tape. This word is derived by 
masking the complement of the 
user's AC1 on a . OPEN com- 
mand with the device's fixed 
characteristics (see DCTFC). 
The device characteristics 
must be assembled into the ta- 
ble; they are not referenced for 
Level 1 devices. 

DCTLK The link to the next priority de- 

vice, a pointer to its control 
table. This word is initialized by 
a .SYSI. The priorities are es- 
tablished by SOS table . OPPP. 

DCTIS The address of the interrupt 

service routine. The address 
must be assembled into the table. 
(See SOS Interrupt Handling, 
page B-4.) 

DCTIL The interrupt frame links. This 

points to the DCT of the last in- 
terrupted device. This word is 
maintained by the SOS interrupt 
service routine. 
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DEVICE CONTROL TABLE (DCT) (Continued) 

Meaning 



Equiva- 
lence Displacement 



10 



11 



DCTDT The Command Dispatch Table ad- 
dress for this device. The Com- 
mand Dispatch Table must be 
ordered in the following manner: 

- open routine address 

1 - close routine address 

2 - read/write sequential routine 

address 

3 - read/write line routine address 

Any of the before mentioned func- 
tions that are illegal for a device 
should contain a -1 in their loca- 
tion. The address must be assem- 
bled into the table. See Device 
Start, Stop, and Dispatch Routines. 

DCTST The address of the device start 
routine. The address must be 
assembled into the table. See 
Device Start, Stop, and Dispatch 
Routines. 

DCTSP The address of the device stop 

routine. The address must be 
assembled into the table. See 
Device Start, Stop, and Dispatch 
Routines. 

DCTFL The device flags. These fiag bits 
are maintained by the global SOS 
subroutines. Three flags are 
currently defined: 

DCACT= 1B15 - Device is active 
(executing I/O). 
Must be off to per- 
form a SOS reset. 



DCACP = 1B8 



A keyboard input 
device may accept 
a character. 



DCKMD= 1B0 - A keyboard input 
device is in echo 
mode. Echo the 
input character. 



DEVICE CONTROL TABLE (DCT) (Continued) 



Equiva - 
lence Displacement 



Meaning 

12 DCTBS The size of the device buffer (in 

bytes for character devices, in 
words for full word devices). It 
must be assembled into the table. 

13 DCTBF Buffer first byte (word) address. If the 

device is a full-word device (DCFWD 
characteristic), then this location must 
contain the beginning word address of 
the buffer. For character devices, this 
word must contain the beginning byte 
address of the buffer. 



14 DCTBL Buffer last byte (word) address. 

15 DCTIP Buffer current input pointer. For an 

output device, this is the byte ad- 
dress at which to store the next 
byte sent to the device from the user 
program. For an input device, this 
is the byte address at which to store 
the next byte received from the de- 
vice. This word is maintained by 
the global SOS subroutines. 

16 DCTOP Buffer current output pointer. For 

an output device, this is the byte ad- 
dress from which to fetch the next 
byte for output. For an input device, 
this is the byte address from which 
to fetch the next byte requested by 
the user program. This word is 
maintained by the global SOS sub- 
routines. 

17 DCTCN Count of active data in the buffer, 

i.e. , bytes not yet sent to the de- 
vice or bytes not yet moved to the 
user program for output and input 
devices respectively. This word is 
maintained by the global SOS sub- 
routines. 
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Equiva - 
lence Displacement 



20 



DCTTO 

DCTCC 



21 



DCTRC 
DCTLC 



23 



DCTFC 



24-32 



Meaning 

Timeout constant (all Input devices). 
Column counter (all output devices). 
For input devices this word repre- 
sents the maximum time Interval 
during which they may have out- 
standing data following a start 
pulse. The parameter "SCTIM" 
defined on the RDOS User Para- 
meter Tape corresponds to a time 
of 1 millisecond on die Supernova 
SC. Then, if a device requires 
6 milliseconds to timeout, the word 
can be assembled as: 

6*SCTIM 

For output devices, this word is 
maintained by the global SOS 
subroutines. 

Restart constant (all Input devices). 
Line counter (all output devices). 
For input devices, if the active 
data count is less than this con- 
stant, another start pulse should 
be sent to the device. This word 
must be assembled into the table. 
For output devices, this word is 
maintained by the global SOS 
subroutines. 



Device attributes. Fixed bit set- 
tings always returned to the user 
in ACO on a .GTATR command. 
Attributes include attribute pro- 
tected, permanent, read protected, 
and write protected. See RDOS 
User Parameter Tape. 

Device fixed characteristics. 
These characteristics, from the 
DOS User Parameter Tape, always 
become the active characteristics 
(DCTCH) after the device is 
.OPENed, unless they are sup- 
pressed by the AC1 mask. 

Device Interrupt Frame. The ma- 
chine state at the time of a device 
interrupt is saved in these DCT 
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DEVICE CONTROL TABLE (DCT) (Continued) 



Equiva - 
lence Displacement 

24-32 (Continued) 



Meaning 

locations. The layout of the 
interrupt frame is as follows: 



24 
25 
26 

27 
30 

31 

32 



IACO 


Saved ACO. 


IAC1 


Saved AC1. 


inu. 




IAC3 


Saved AC3. 



IPC Program Counter. (Location 

when the interrupt was taken. ) 

IRLOC Volatile SOS linkage cell. 

IMSK Interrupt enable mask when the 

interrupt was taken. The carry 
bit Is saved in bit 14 of this word. 



DCT displacements 6-23 (DCTDT - DCTFC) are not 
referenced by Level 1 devices, with the exception of 
DCTFL, bit 15, which must be off to perform a SOS 
reset command, and DCTSP, which is executed on 
. SYSI and . RESET commands. For Level 2 devices, 
the Dispatch Table (DCTDT) must be defined. Use of 
the remaining elements depends on the definitions of 
this table; if any of the global SOS routines are invoked, 
then any or all of these elements may be referenced. 

DEVICE PRIORITY TABLE 

This table is referenced by the SOS initialization procedure 
(system, call . SYSI) in order to establish the Device Control 
Table link words (DCTLK). The order inwhichthe DCTlsare 
linked determines the order in which the SOS devices 
are searched for a matching code on an interrupt. This 
table is normally embedded in SOS-MAIN. If the ex- 
ternal normal .OPPP in SOS is resolved, however, then 
a uBer supplied table is used to establish the links. The 
SOS-MAIN table is set up as follows: 

.PTRP 

.CDRP 

. MTAP 

. CTAP 

.TTRP 

.PTPP 

.LPTP 

. PLTP 

.TTOP 
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APPENDIX B - ADDING DEVICE HANDLERS TO SOS 
DEVICE PRIORITY TABLE (Continued) 



Each of the symbols ending in "P" is declared an entry in 
the SOS-MAIN program. The table is always terminated 
with a zero word. This table reflects a descending pri- 
ority level of the SOS devices, beginning with the $PTR 
and ending with the $TTO. 

As an example of a user supplied table, consider the ad- 
dition of devices XXX and YYY, where XXX should be the 
highest priority device and YYY has a priority less than 
the MTA but higher than the $TTR. The critical program 
declarations to achieve this priority scheme wouldappear 
as follows: 



.ENT .OPPP 

.NREL 

.EXTN .PTRP. .CDRP, .TTRP, . PTPP, . LPTP 

.EXTN .TTOP, .MTAP, .CTAP 

. OPPP: . XXXP 
.PTRP 
.CDRP 
.MTAP 
.CTAP 
.YYYP 
.TTRP 

.PTPP 
• LPTP 
.PLTP 
.TTOP 


.XXXP: XXXDC -.POINTER TO XXX DCT 
.YYYP: YYYDC : POINTER TO YYY DCT 

This table must be defined for Level 1 and Level 2 SOS 
devices. 

CHANNEL - NUMBER-TO-DEVICE MAP 

This table is referenced by the SOS command dispatch 
routine. If a SOS I/O command has referenced a channel 
number outside of the legal SOS range and the SOS exter- 
nal normal, .OPTP has been resolved, then this table is 
expected to point to a list of Device Control Table ad- 
dresses. These addresses must be ordered by channel 
number, beginning at channel number 30 (HCHNO+1 
from the SOS parameters), Thus if devices XXX and YYY 
were being incorporated into SOS for Level 2 compati- 
bility and XXX were assigned to channel 30 and YYY to 
channel 31, the critical program declarations would be 
as shown in the next column. 



PHANNFT. -NUMBER-TO-DEVICE MAP (Continued) 



.OPTP: 
.XXXP: 
.YYYP: 



.ENT 



.NREL 
. +1 
XXXDC 
YYYDC 



.OPTP 



;POINTER TO XXX DCT 
;POINTER TO YYY DCT 



This table must be supplied for Level 2 compatibility. 
The table is expandable from channel number 
"HCHNO+1" to number 76. 

SOS INTERRUPT HANDLING 

When an interrupt is taken, a SOS module preserves the 
the interupted machine state. The DCT interrupt frame 
(IACO - IMSK) is utilized in these procedures, and when 
the device interrupt handler gains control, the "save" 
is complete and the mask in the device 's Control Table 
(DCTMS) is active. The following functions are the re- 
sponsibility of the interrupt routine (DCTIS): 

1. Clearing the done flip-flop in the device. 

2. Storing/retrieving the next character in the device 

buffer. 

3. Restarting the device when appropriate. 

4. Returning to the SOS interrupt module. 

The SOS stack mechanism may not be invoked at inter- 
rupt processing time. The SOS modules . IBUF and 
. OBUF may be called, however, since they do not re- 
quire a stack frame (see SOS global subroutines). 

Two simple interrupt routines, one for output device 
$PTP and one for input device $PTR, illustrate the above 
points : 



PTRS: DIAC l.PTR 



JSR 
JMP 



@ADRIB 



NIOS PTR 



ADRIB: 



JMP 

.EXTN 
.DISM 

.EXTN 
.IBUF 



@.+l 
,DISM 



.IBUF 



RETRIEVE CHARACTER/ 

CLEAR DONE 

STORE CHARACTER IN THE 

DEVICE'S BUFFER 

AN IMPOSSIBLE RETURN - 

BUFFER ALREADY FULL 

RESTART $PTR. THE 

BUFFER IS NOT YET FULL 

;DON'T RESTART $PTR. THE 

BUFFER BECAME FULL 

;RETURN TO THE SOS 
INTERRUPT MODULE 

;ENTRY POINT 
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SOS INTERRUPT HANDLING (Continued! 



FTPS: NIOC 
JSR 



DOAS 



FTP 
@ADROB 



l.PTP 
@.+l 



JMP 
.DISM 



. EXTN .OBUF 
ADROB: .OBUF 



;CLEAR DONE. 

:RETRIEVE NEXT CHARAC- 

;TER FROM THE DEVICE'S 

;BUFFER. 

;RESTART DEVICE AND 

;SEND THIS CHARACTER IF 

. iiia ivb iuiun utivic HCR.C 

;OTHERWISE DON'T 

•.RESTART. 

;RETURN TO THE SOS 

:INTERRUPT MODULE. 

;ENTRY POINT. 



DEVICE START, STOP, AND DISPATCH ROUTINES 

Device Start Routine 

The address of this routine is at displacement DCTST in 
the DCT. For output devices, this routine should send 
a start pulse plus the character from AC1. If the device 
will not interrupt as a result of this action, return to one 
location beyond the normal return location. Otherwise, 
return to the normal location. AC3 points to the normal 
return location. As an illustration, consider the line 
printer start routine: 



LPTST: DOAS l.LPT 

SKPBZ LPT 

JMP 0, 3 

JMP 1, 3 



START LPT, OUTPUT THE 

CHARACTER. 

WILL IT INTERRUPT? 

YES 

NO 



For input devices, this routine should send a start pulse 
and return to the normal return location. For example, 
the $PTR start routine is: 



PTRST: 



NIOS 
JMP 



PTR 
0, 3 



;SEND START PULSE. 
;RETURN 



Device Stop Routine 



The address of this routine is at displacement DCTSP in 
the DCT. This routine should simply send a clear pulse 
and return to the normal return location. Using the 
$PTR"as an example: 

PTRSP: NIOC PTR ;SEND CLEAR PULSE. 

JMP 0, 3 -.RETURN 



APPENDIX B - ADDING DEVICE HANDLERS TO SOS 
Device Dispatch Routines 

till- uctiLC uiaLJclli~li lauic auuxcao la ai uiai/iacvtiii-iti 

DCTDT in the DCT, as previously described. If the 
global SOS routines are not invoked for any of the four 
functions, then the following points should be noted in 
the dispatch routine: 

i. ACS points to the error return location. 
Increment by one for a success return. 

2. The contents of the user accumulators are: 



nv^u - f**K c *ci»j uiBfjiacciiiciti <_r»v_.<j . 

AC1 - page zero displacement "CAC1". 
AC2 - UST displacement "USTA2". 

If an accumulator is being returned to the user, 
then the appropriate location must be changed. 

3. AC2 points to the DCT when the dispatch rou- 
tine gains control. 

If the global SOS routines are used, then they may be 
invoked directly (by assembling their addresses into the 
dispatch table. ) 

SOS LINKAGE 



A simple stack mechanism is employed in SOS at the 
non-interrupt level. This mechanism provides a means 
of saving the calling routine's accumulators and of 
operating on variables stored in the stack. No stack 
mechanism is provided for interrupt processing, but 
the state of the current stack must be preserved when- 
ever an interrupt is processed. The SOS interrupt 
dispatch routine performs this service. 

The linkage scheme used in SOS makes use of several 
page zero locations and of a fixed block of core assem- 
bled into the SOS module. The size of this core block 
permits a "depth" of six calls from the common SOS 
entry point at the start of the program. The page zero 
locations and equivalences that are used in the linkage 
mechanism include: 

SAVE - (JSR @3) invokes the routine which saves ac- 
cumulators and updates the stack pointer. 

RTRN - (JMP @4) invokes the routine which restores 
the caller's accumulators and returns to him. 



This routine is executed for each device on any . RESET 
or . SYSI . 
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APPENDIX B - ADDING DEVICE HANDLERS TO SOS 

SOS LINKAGE (Co ntinued) 

CSP - (Page Zero Location) always points to the 
stack frame currently in use. 

RLOC - ( Page Zero Location) used as a temporary 
by the SAVE routines; may also be used as 
a temporary by any routine in lieu of allo- 
cating a stack frame. 

The stack frame is a fixed size with the following dis- 
placements defined: 

RTLOC - The return location in the current subrou- 
tine (location which it last "called".) 

ACO - Contents of accumulator of the current 
subroutine at the last call which it made. 



AC1 



Same as above; accumulator 1. 



TMP - Available for use by the current subroutine 
as a temporary. 

OACO - Contents of caller's accumulator 0. 

OAC1 - Contents of caller's accumulator 1. 

OTMP - Caller s temporary. 

ORTN - Caller's return location. 

Following a SAVE or a RTRN, AC3 always points to the 
current stack frame, and each of the above locations 
may be referenced as displacements from it. Other- 
wise, the CSP may be loaded into an index accumulator 
in order to reference the locations. (Accumulator 2 is 
never saved since it usually contains a Device Control 
Table address and is passed as an argument from sub- 
routine to subroutine.) 

The typical procedures executed in using the mechanism 
are as follows: 

1. A routine (B) is called by another routine (A) 
through the JSR instruction: 

JSR B 

or 
JSR @ADDRB 

ADDRB: B 



SOS LINKAGE (Continued) 

2. Routine B saves the caller's return location 
when it begins execution with: 

STA 3, @CSP 

3. Routine B may, at any time thereafter, perform a: 

SAVE 

to save the caller's accumulators, allocate a 
stack frame, and update the CSP appropriately. 

4. To return to A, routine B simply performs a: 

RTRN 

If no frame is required by B, it may save the 
caller's return location in RLOC: 



STA 



3, RLOC 



It may then use any accumulator and operate on 
A's frame (by loading CSP into an index accumu- 
lator) if it wishes. It should perform the return 
in the following manner: 

LDA 3. CSP 

JMP @RLOC 

so that when A regains control, accumulator 3 
is pointing to its frame. Note that the accumu- 
lators upon this return are exactly as they were 
left by routine B, rather than as they were when 
A called B. 

GENERALIZED SOS SUBROUTINES 

The global routines defined as entries in SOS are as 
follows: 

. OPN - Open 

. CLS - Close 

.WRSE - Write sequential 

.WRLI - Write line 

. RDSE - Read sequential 

. RDLI - Read line 

.ACHR - Send a character 

.RCHR - Read a character 

. IBUF - Input a character to buffer 

. OBUF - Output a character from buffer 

. STB - Store a byte 

. LDB - Load a byte 

.DISM - Dismiss an interrupt 
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These routines are available for use with any programs 
loaded with SOS. The calling procedures and brief de- 
scriptions are given below: 

.OPN 



Calling 

Sequence: JSR .OPN 

All references to JSR .XXX instructions, 
....ere .XXX *s an entry point, are equiva- 
lent to the following instruction sequence: 

JSR @XXX 

* 

• XXX 

Arguments: AGO = Byte address of the file name if the 
device is an intervention device. 
Otherwise, ACO is ignored. 
AC2 = Pointer to the DCT. 



Return 
Sequence: 



Always returns to calling location +2 with 
the accumulators unchanged. 



Description: The device's active characteristics are de- 
rived by ANDing the complement of the 
user's AC1 and the device's fixed charac- 
teristics (DCTFC); they are stored at 
DCTCH. Then, if the device being opened 
is an intervention device, a prompt mes- 
sage is typed. If the device requires 
leader/trailer, it is punched. The device 
is aiways cieared (DCT stop routine) and 
the Device Control Table is initialized. 

.CLS 

Calling 

Sequence: JSR . CLS 

Arguments: AC2 = Pointer to the Device Control Table. 

Return 

Sequence: Always returns to calling location +2 with 
the accumulators unchanged. 

Description: If the device being closed requires leader/ 
trailer, it is punched. When the device is 
no longer active, it is cleared and its 
Device Control Table is initialized. 



1HB blAND-ALUNh, OPtSKAilNU SYSTEM 
APPENDIX B - ADDING DEVICE HANDLERS TO SOS 

GENERALIZED SOS SUBROUTINES (Continued) 

.WRSE 



Calling 
Sequence: 

Arguments: 



Return 

Sequence: 



Description: 



■WRLI 

Calling 
Sequence: 



JSR .WRSE 

"CACO" * * Beginning byte address for 

transfer 
"CAC1" * - Byte count for transfer 
AC2 = Pointer to Device Control Table 



"»"»;» **.».«**.**» w ^arUULULg u/wauuii Ti< Willi 

the accumulators unchanged. 



The specified number of bytes are in- 
serted into the device's buffer for output. 



JSR .WRLI 



Arguments: CACO = Beginning byte address for the 
transfer 
AC2 = Pointer to the Device Control 
Table. 



Return 
Sequence: 



The accumulators are unchanged, except 
CAC1 which contains the count of bytes 
written. A return to the calling location+1 
indicates the maximum line length was ex- 
ceeded. A return to calling locatlon+2 is 
normal. 



Description: The specified ASCII characters are in- 
serted into the device's buffer for output. 
The character string that is output is 
terminated by: 

1. carriage return 

2. form feed 

3. null byte 

Line editing is done, based on the charac- 
teristics of the device. 



Page zero displacements from the SOS Parameter Tape. 
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APPENDIX B - ADDING DEVICE HANDLERS TO SOS 

GENERALIZED SOS SUBROUTINES (Continued) 

• RDSE 



Calling 
Sequence: 

Arguments: 



Return 
Sequence: 



JSR . RDSE 

CACO = Beginning byte address for the 

transfer 
CAC1 = Byte count for the transfer 
AC2 = Pointer to Device Control Table 



A return to calling location+1 indicates 
either end of file or illegal command for 
the device. A return to calling location+2 
is normal. The accumulators are un- 
changed. CAC1 contains the partial count 
read on an EOF return. 



Description: The specified number of bytes are placed 
in the user area from the device's buffer. 

.RDLI 

Calling 

Sequence: JSR . RDLI 

Arguments: CACO = Beginning byte address for the 
transfer 
AC2 = Pointer to Device Control Table 



Return 
Sequence: 



A return to calling location +1 indicates 
either end of file, line length exceeded, or 
parity error. In this case, AC1 contains 
the partial count of bytes read and CAC2 ** 
contains the error code. A return to 
calling location+2 is normal, with accu- 
mulators unchanged except CAC1 which 
contains the count of characters read. 



Description: The specified ASCII characters are 

inserted into the user area from the de- 
vice's buffer. The character string is 
terminated by: 



1. 
2. 



carriage return 
form feed 



Nulls, rubouts, and line feeds are ignored. 



•* UST displacement from the SOS Parameters (PARA. SR). 



.RCHR 

Calling 

Sequence: JSR . RCHR 

Arguments: AC2 = Pointer to Device Control Table 



Return 
Sequence: 



A return to calling location+1 indicates 
device timeout (end of file). In this case, 
the accumulators are unchanged with the 
error code in CAC2. A return to calling 
location+2 is normal. In this case, the right 
justified byte (word)* that is read is in AC1 
with the other accumulators unchanged. 

Description: The next available byte is read from the de- 
vice's buffer into AC1. If necessary, a 
start pulse is issued to the device. 

.ACHR 



Calling 
Sequence: JSR 



.ACHR 



Arguments: AC1 = Right justified byte to be sent. 

AC2 = Pointer to the Device Control Table 

Return 

Sequence: A return is always made to calling location+l 

with the accumulators unchanged, 

i 

Description: The byte is inserted into the device's buffer 
for output. If necessary, a start pulse is 
Issued to the device. 

.IBUF 



Calling 
Sequence: 



JSR . IBUF 



Arguments: AC1 = Right justified byte to be inserted 
into buffer 
AC2 = Pointer to Device Control Table 



Return 
Sequence: 



A return to the calling location +1 indicates 
the buffer is already full. A return to call- 
ing location+2 indicates the character was 
inserted and the buffer is not full. A return 
to calling location+3 indicates the charac- 
ter was inserted and the buffer became full. 
In e"very case, the accumulators are un- 
changed, except ACO, which is destroyed. 



* Input devices with the.characteristic, DCFWD, always 
operate on words rather than bytes. 
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GENERALIZED SOS SUBROUTINES (Continued) 



mi IP (fV>nHn!ipH\ 

1 *"V *■ \^->\S*»l«.llUW\4/ 



Description: The byte (word) is placed in the appropri- 
ate buffer slot and the Device Control Ta- 
ble is updated accordingly. This routine 
is used at the interrupt processing level 
by input devices and at the non-interrupt 
level by output devices. 

.OBUF 

Sequence: JSR .OBUF 

Arguments: AC2 = Pointer to Device Control Table 



Return 
Sequence: 



A return to calling location +1 indicates 
the buffer is empty. A return to calling 
location+2 indicates the buffer is not 
empty. In this case, the next available 
byte (word) is fetched from the buffer and 
returned right justified in AC 1. In both 
cases, ACO is destroyed and the other 
accumulators are unchanged. 



Description : The byte (word) is fetched from the appro- 
priate buffer slot into AC1 and the Device 
Control Table is updated accordingly. 
This routine is used at the interrupt pro- 
cessing level by output devices (to fetch 
their next byte for output) and at the non- 
interrupt level by input devices (to re- 

* t-i-l*»v#> hiitAc firim fhpir htiff^r^c^ 



APPENDIX B - ADDING DEVICE HANDLERS TO SOS 
GENERALIZED SOS SUBROUTINES (Continued) 



Calling 

Sequence: JSR . LDB 

Arguments: ACO = Source byte address 



Return 
Sequence: 



The return is always made to calling loca- 
tion+1 with the right justified byte in AC1. 
The other accumulators are unchanged. 



Description: The byte at the specified address is loaded 
and returned in AC1. 

■ DISM 

Calling 

Sequence: JMP . DISM 

Arguments: None. 



Return 
Sequence: 

Description: 



No return. 

This routine restores the machine to the 
state it was in before the device inter- 
rupted. Control is passed to this point 
when the Interrupt from the device has 
been serviced. 



.STB 

Calling 
Sequence: 



JSR . STB 



Arguments; ACO = Destination byte address 
AC1 = Right justified byte 



Return 
Sequence: 



The return is always made to calling 
location +1 with ACO incremented and the 
other accumulators unchanged. 



Description: The passed byte is stored at the specified 
address. 
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Up to eight cassette drives and eight magnetic tape drives 
are permitted per system. Magnetic tape drives must be 

set to iu B n ucuHiiy vouuopi). tach cassette 

or magnetic tape drive used at a given time must be 
supported by a separate support program. The number 
of cassette or magnetic tape drives'supported by an 
SOS program is determined by the number of support 
programs Includedin the configuration of the program. 
The units supported in a given configuration are numbered 
consecutively starting with 0. For example, if three 
cassette drives are supported they will be CTO, CT1, 
and CT2. (See Chapter 6, Configuring SOS Utility 
Programs). 

When running programs under SOS with the DSOSI 
program, cassette and magnetic tape units are referenced 
by file name. For magnetic tape units: 

MTO 
MT1 



MT7 

For cassette units: 

CTO 
CT1 

CT7 
When running programs under SOS without the DSOSI 

nmoram r*a aor\t+n an/1 rv-> a m* ***•*» *»_» .._].._ - r 

by channel number. For magnetic tape units: 



APPENDIX C - SOS CASSETTE AND MAGNETIC TAPE FILES 

The device name and file number are specified at the 
time the file is opened. When performing a . OPEN 
command under SOS with the DSOSI program. ACO 
must contain a byte pointer to the unit name/file 
number. The string has the format: 

MTx:y^ for magnetic tape units 

CTx:yj for cassette units 

where: x is the unit number ( - 7 ) 

yX is the file number ( - 99 ) 

File numbers may be given in single -digit or double 
digit format. For example: 



20 = MTO 

21 = MT1 



27 


= 


MT7 


For cassette units: 


30 


= 


CTO 


31 


= 


CT1 



MT1:4 



and MT1:04 



are equivalent references to the fifth file on magnetic 
tape unit 1. 

When performing a . OPEN command without DSOSI, 
the channel number upon which the file is opened 
(20-27 for magnetic tape units; 30-37 for cassette 
units) is given in the command. ACO contains the 
file number, which in thi6 case may be any positive 
number ( - 99iq ). 

When performing a . OPEN command with or without 
DSOSI, the characteristics mask is ignored since 
all cassette and magnetic tape files are attribute 
protected (see .GTATR command, page 3-3). The 
other SOS I/O commands (. RDL. . RDS, . WRL, 
. WRS, and . CLOSE) are used with cassette or 
magnetic tape files in the standard manner discussed 
in Chapter 3. 

NOTE: No magnetic tape file may ever be 
written unless the write permit ring is inserted 
in the tape reel. No cassette file may ever be 
written unless the file protect tabs are In 
place on the cassette. 

Data is written onto and read from cassette and 
magnetic tapes in fixed length blocks of 257 10 16-bit 
words. The first 255 words of each block are data 
and the last two contain the file number: 



37 = CT7 

Cassette or magnetic tape files are referenced by file 
number under SOS. Each cassette or magnetic tape unit 
may have up to 100 files numbered through 99. Files 
must be written consecutively starting with file 0. 



DATA WORDS 



FILE NUMBER 



FILE NUMBER 



255 words 

1 word 
1 word 



C-l 



THE STAND-ALONE OPERATING SYSTEM 



APPENDIX C - SOS CASSETTE AND MAGNETIC TAPE FILES 

Files are variable In length, each consisting of as many 
fixed length blocks as required. If the last block is not 
completely used, the remainder is padded with nulls. 
Consecutive files are separated by end-of-file (EOF) 
marks. Two EOF marks follow the last file written. 
All tapes have the following format: 

Start of reel 
File (iiq blocks) 
EOF mark 
File 1 (ni blocks) 
EOF mark 



File K (n k blocks) 
EOF mark 
EOF mark 

Whenever a file is written, two EOF marks are written 
following it. Since a pair of consecutive EOF marks 
always indicate the end of tape to SOS, overwriting a 
file makes Inaccessible any succeeding files that were 
written previously. For example, if file 3 were over- 
written on a tape containing 13 files (files through 12), 
files 4 through 12 on that tape would become inaccessible 
to SOS. The next file written on that tape would be a 
new file 4. Attempts to write any other file at that point 
would result in a 'FILE NON-EXISTENT' error code. 



C-2 



THE STAND-ALONE OPERATING SYSTEM 
APPENDIX D - SOS PARAMETER TAPES 



'SOS USER APPLICATION PARAMETERS <PAKUA> 
* STACK DISPLACEMENTS 



• OUSh 


SSEL* 


6 


• DUSh 


SOSEC= 


S 


• DUSh 


Mki 


a 


* ft.'Lr*?H 


T0 = 


i 


• DUSh 


Tl* 


2 


• DUSK 


SAC0 = 


3 


• DUSK 


SACl* 


A 


• DUSh 


SAC2» 


5 


• DUSH 


OAC0 = 


SAC0-SSEL 


• DUSh 


OACl" 


SAC1-SSEL 


• DUSh 


UAC2* 


SAC2-SSEL 


• DUSR 


ORTR* 


hTR-SSEL 


• DUSK 


OT0» 


T0-SSEL 


• DUSR 


OT|* 


Tl-SSEL 




' COMMAND TABLE DI. 


• DUSh 


CTBP = 





• DUSh 


CTSw= 


1 


• DUSR 


CTNBP« 


2 


• DUSh 


CTEL" 


2 




' COMMAND TABLE SWI 


• DUSh 


SW0B 


1B0 


• DUSR 


SW]> 


1BI 


• DUSR 


SW2« 


IB2 


• DUSR 


SW3* 


1B3 


• DUSK 


SW4« 


1B4 


• DUSh 


SW5« 


IBS 


• DUSR 


SW6* 


186 


• DUSR 


SW7« 


IB7 


• DUSR 


SW8* 


IBS 


• DUSR 


SW9> 


1B9 


• DUSR 


SW10* 


1B10 


• DUSR 


SWM> 


IBM 



'ENTRY LENGTH 

'ENTRY COUNT *OR SOS USER ROUTINES 

'FhAME LAYOUT! 

' hETUhN LOCATION 

' TEMPORARIES 

' SAVE ACCUMULATORS 



i THESE DISPLACEMENTS PERMIT 

* "CALLEE" TO GET AT "CALLER'S" 

1 hEGISTEhS 



/STRING BYTE POINTER 

' SWITCH WORD 

JNEXT STARTING BYTE POINTER 

I ENTRY LENGTH 



' EACH OF THESE BIT SETTINGS 
I MAY BE EQUIVALENCED TO A MEAN- 
INGFUL VALUE IN THE USER APPLI- 
CATION PROGRAM. THE ARRANGEMENT 
J OF THE TRANSLATE TABLE (TRT) 
'DETERMINES THE PRECISE MEANING 
'OF EACH SWITCH. 
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t 
1 
I 


SOS PARAMETERS 


I 




LINKAGE 


.DUSK 


SAVEs 


JSR »3 


• DUSK 


RTRNa 


JMP »A 


• DUSK 


RTLOO 





• DUSK 


AC0* 


1 


• DUSK 


AC1» 


2 


.DUSR 


TMP = 


3 


• DUSR 


SLGT» 


TMP+1 


.DUSR 


OAC0« 


AC0-SLGT 


.DUSR 


OACI« 


AC1-SLGT 


• DUSR 


OTMP» 


TMP-SLGT 


.DUSR 


ORTN* 


RTLOC-SLGT 


.DUSR 


NFRAM* 


6. 


.DUSR 


SS2* 


NFRAM*SLGT 


I 




PAGE ZERO 


• DUSR 


RLOC" 


6 


• DUSR 


CMSK- 


7 


• DUSR 


CSP = 


10 


• DUSR 


CDCT» 


12 11 


• DUSR 


BDCT« 


13 IE 


• DUSR 


CAC0» 


14 


• DUSR 


CAC1» 


IS 



UN SERVICE DCT 

J BEGINNING OF DCT CHAIN 



ADDITIONAL UST DEFINITIONS 



DUSR 


USTA0« 


20 


DUSR 


USTA1» 


USTA0+1 


DUSR 


USTA2* 


USTA1+1 


DUSR 


USTA3* 


USTA2+1 


DUSR 


USTCY = 


USTA3+1 


DUSR 


USTIS« 


USTCY+1 


DUSR 


USTWA* 


USTIS+1 


.DUSR 


USTRS» 


USTWAM 


• DUSR 


UFTEC" 


10 


.DUSR 


UFT» 


UST+UFP 



J ENTRY COUNT OF UFT'S 
UST+UFPT+UFTEC i START OF UFT TABLE 

ADDITIONAL DEVICE CHARACTERISTICS 



.DUSR DCDIR« 1B0 



J SOS DATA CHANNEL DEVICE 
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i DEVICE CONikOL TABLE (DCT) LAYOUT 
J COMMON TO ALL DEVICES 



•DUSR DCT CD" 
• DUSR DCTMS« 




I 



I DEVICE CODE 

1 MASK OF LOWER PRIORITY DEVICES 



I DEFINE THE MASK BITS 



• DUSR 

• DUSR 

• DUSR 

• DUSR 

• DUSR 

• DUSK 

• DUSR 

• DUSR 

•DUSR DCTCHb 
•DUSR DCTLK= 

•DUSR DCT IS* 
•DUSR DCTILs 



MSTTO« 
MSTTI- 

MSPTP« 
MSLPT- 
MSCDR* 
MSPLT- 
MSMTA« 
MSPTK» 

2 
3 

A 
5 



IBIS 
IBM 

1B13 
1B12 
1B10 
1B12 
1B10 
1B11 

1 DEVICE CHARACTERISTICS - 

1 LINK TO NEXT DCT 

i C-l TERMNATES THE CHAIN) 

I INTERRUPT SERVICE ROUTINE ADDRESS 

I INTERRUPT MACHINE STATE LINK 



•DUSR DCTDT« 

-DUSR DCTST* 

•DUSR DCTSP* 

•DUSR DCTFL> 



6 
7 

10 
11 



I COMMAND DISPATCH TABLE ADDRESS WORD 

i ADDRESS OF DEVICE START ROUTINE 

I ADDRESS OF DEVICE STOP ROUTINE 

I FLAGS (ACTIVE* ATTACHED* ETC) 



I DEFINE THE FLAGS 
•DUSR DCACT" IBIS 
•DUSR DCACPT* IBS 
• DUSR DCKMD* 1 B0 



I ACTIVE FLAG 

I ACCEPT CHARACTER FLAG 

i TTY KEYBOARD MODE FLAG 



COMMON TO DEDICATED DEVICES (I.E. SINGLE USER/SINGLE BUFFER) 

i BUFFER SIZE ( BYTES ) 

1 BUFFER FIRST ADDRESS (BYTE > 

t BUFFER LAST ADDRESS 

I BUFFER INPUT POINTER (BYTE ) 

J BUFFER OUTPU POINTER 

J COUNT OF ACTIVE DATA 

J TIMEOUT WORD (ALL INPUT DEVICES) 

I COLUMN COUTER (ALLOUTPUT DEVICES) 

I RESTART CONSTANT (ALL INPUT DEVICES) 

I LINE COUNTER (ALL OUTPUT DEVICES) 

I DEVICE ATTRIBUTES 

I DEVICE FIXED CHARACTERISTICS 

I LOWEST LEGAL CHANNEL « 

I HIGHEST LEGAL CHANNEL # 

I NOTE - ONE OR BOTH OF THESE EQUI- 

I VALENCES MAY BE CHANGED TO ADD 

I DEVICE DRIVERS 



.DUSR 


DCTBS» 


12 


• DUSR 


DCTBF* 


13 


• DUSR 


DCTBL* 


14 


• DUSR 


DCTIP« 


15 


• DUSR 


DCTOP" 


1 6 


• DUSR 


DCTCN« 


17 


• DUSR 


DCTTO« 


20 


• DUSR 


DCTCC* 


20 


• DUSR 


DCTRC> 


21 


• DUSR 


DCTLC* 


21 


• DUSR 


DCTAT- 


22 


• DUSR 


DCTFC* 


23 


• DUSR 


LCHNO* 


6 


• DUSR 


HCHNO* 


37 
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APPENDIX D - SOS PARAMETER TAPES 



I MAG TAPE PARAMETERS 



DUSR 


MTBWZ" 


377 J BUFFER WORD SIZE 


DUSR 


MTBBZ- 


MTBWZ*2 JBUFFER BYTE SI2E 


DUSR 


CTBWZ" 


MTBWZ 


DUSR 


CTBB2- 


MTBB2 



INTERRUPT FRAME TEMPLATE 



• DUSR 


IAC0* 


DCTFC+I 


.DUSR 


IAC1' 


IAC0+I 


• DUSR 


IAC2* 


IACl+1 


• DUSR 


IAC3* 


IAC2+1 


• DUSR 


IPC* 


IAC3+1 


.DUSK 


IRLOC* 


IPC*1 


• DUSR 


IMSK = 


IRLOC-H 


.DUSR 


IFRL* 


7 



J INTERRUPT FRAME LENGTH 



1 DEFINE THE CLI STACK DISPLACEMENTS 



• DUSR 


SSLGT» 


-7 


.DUSR 


SSOSP= 


-6 


• DUSR 


SSRTN- 


-S 


.DUSR 


SSEAD= 


-A 


• DUSR 


SSCRY= 


-3 


• DUSR 


SSAC0- 


-2 


• DUSR 


SSACl« 


-1 


.DUSR 


SSAC2* 






t VARIABLE LENGTH OF CALLING'S FRAME 

J PREVIOUS STACK POINTER 

1 RETURN ADDRESS OF CALLING PROGRAM 

J ENTRY ADDRESS OF CALLED ROUTINE 

1 CARRY 

J SAVE STORAGE FOR CALLING'S ACCUMULATORS 

I (DON'T MODIFY THIS DISPLACEMENT! I > 



I DEFINE THE CLI SIZE 
•DUSR CLIN> 13015 



I CLI NREL 



1 UFT 
1 


ENTRY 


.DUSR 


UFTFN=0 


• DUSR 


UFTEX*5 


• DUSR 


UFTAT«6 


.DUSR 


UFTBK«7 


• DUSR 


UFTBC-10 


• DUSR 


UFTAD=11 


• DUSR 


UFTDLM2 


.DUSR 


UFTDC»I3 


• DUSR 


UFTUN=14 


• DUSR 


UFTCA*15 


.DUSR 


UFTCB=16 


• DUSR 


UFTST=17 


.DUSR 


UFTNA=20 


.DUSR 


UFTLA=21 


• DUSR 


UFTDR=22 


.DUSR 


UFTFA=23 



•DUSR UFTBN=24 

.DUSR UFTBP=2S 

.DUSR UFTCH«26 

•DUSR UFTCN»27 



J FILE NAME 

J EXTENSION 

I FILE ATTRIBUTES 

JNUMBER OF LAST BLOCK IN FILE 

1 NUMBER OF BYTES IN LAST BLOCK 

I DEVICE ADDRESS OF FIRST BLOCK 

JDCT LINK 

JDCT ADDRESS 

J UNIT NUMBER 

» CURRENT BLOCK ADDRESS 

1 CURRENT BLOCK NUMBER 

J FILE STATUS 

J NEXT BLOCK ADDRESS 

1LAST BLOCK ADDRESS 

1SYS.DR DCB ADDRESS 

J FIRST ADDRESS 



J CURRENT FILE BLOCK NUMBER 

I CURRENT FILE BLOCK BYTE POINTER 

t DEVICE CHARACTERISTICS 

I ACTIVE REQ COUNT 

>B0 INDICATES Q -0-DS81 » 1»DSQ2 



(0 UNASSIGNED) 



.DUSR UFTEL-UFTCN-UFTFN+I 
.DUSR UFDEL-UFTDL-UFTFN*! 



J UFT ENTRY LENGTH 
IUFD ENTRY LENGTH 
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> SYSTEM FILE ENTRY 
J 

.DUSR SFKEY = -5 
•DUSR SFLK=-4 
-DUSK SFNX=~3 
•DUSR SFBK=-2 
•DUSR SFBC=~1 
•DUSR SFDCB=0 



1KEY 

IMAP.DR LINK (-1 IF NOT DSK DVC) 

iNEXT ENTRY IN CHAIN 

JNUMBEk OF LAST BLOCK IN FILE 

J BYTE IN LAST BLOCK 

IDCB ENTRY 



•DUSR UDBAT=UFTAT-UFTDC ^NEGATIVE DISP. TO ATTRIBUTES 

•DUSR UDBAD=uFTAD-UFTDC 1NEGAVIE DISP. TO FIRST ADDRESS 

•DUSR UDBBK=UFTBK-UFTDC JNEGATIVE DISP. TO LAST BLOCK 

•DUSR UDBBN*UFTBN-UFTDC ^POSITIVE DISP. TO CURRENT BLOCK 



FILE ATTRIBUTES 



.DUSR ATRP=1B0 J READ PROTECTED 

.DUSR ATCHA=1B1 1 CHANGE ATTRIBUTE PROTECTED 

•DUSR ATSAV=1B2 i SAVED FILE 

•DUSR ATLNK=1B3 JPART DISK LINK 

.DUSR ATPAR=1B4 JPARTITIONED 

• DUSR ATC0N=IB12 J CONTIGUOUS FILE 

.DUSR ATRAN=IB13 1 RANDOM FILE 

.DUSR ATPERMBJ4 IPERMANENT FILE 

.DUSR ATWPMB15 I WRITE PROTECTED 



FILE STATUS 



•DUSR STER-1B1S 
.DUSR STIQP S 1B!4 
•DUSR STFWR=1B13 
•DUSR STINI=IB1 
•DUSR STCMK=1B0 



J ERROR DETECTED 

IT /n TM DOrtr?L>CCC 
* * r VS * I* f ixuun CUiJ 

I FIRST WRITE FLAG 
JNO INIT BIT 
JSET = READ (FILIO) 
1 UNIT/RELEASE SWTCH 



FOR SYS.DR DCB) 



BUFFER STATUS 



• DUSR 
.DUSR 

• DUSR 
.DUSR 
.DUSR 

• DUSR 



QTM0DMB15 

9TERMB14 

QTI0P«1B12 

QTLCKMB1I 

QTIND»IB10 

QTEMD«IB9 



J HAS BEEN MODIFIED 

i ERROR DETECTED 

J 1/0 IN PROGRESS 

I BUFFER LOCKED 

I INDIRECT MODE (ADDRESS IN BQNXT) 

I ERROR MODE (MAG TAPE) 
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1 SYSTEM CONSTANTS. 
i 


.DUSK 


SCWPB=255. 


.DUSR 


SCLL6=132. 


.DUSR 


SCAMX=24. 


• DUSK 


SCFNL=UFTEX-UFTFN+ 


• DUSR 


SCMER=10. 


.DUSR 


SCSTR=16 


• DUSR 


SCTIM=-80. 


.DUSR 


SCSYS=1 


• DUSR 


SCSVB=SCSYS+1 


• DUSR 


SCPNM=4 


• DUSR 


SCEXT = UFTEX-UFTFN 


.DUSR 


SCRRL=64. 


• DUSR 


SFINT=1B0 


• DUSR 


SFCRD=1B13 


• DUSR 


SFPRD=IB14 


.DUSR 


SFBRK=1B15 


• DUSR 


FADH = 40 


• DUSR 


SCZMX=FADZ+1 


• DUSR 


SCFUL=SCZMX+1 


• DUSK 


SCPAR=SCFUL+1 


• DUSR 


SCP0V=SCPAR+1 


• DUSR 


SCKEY = SCP0V+1 


.DUSR 


SCCLI=SCKEY+1 


.DUSR 


SCIDV=SCCLI*1 



» WORDS PER BLOCK 

J MAX LINE LENGTH 

J MAX ARGUMENT LENGTH IN BYTES 

1 J FILE NAME LENGTH 

I MAX ERROR RETRY COUNT 

J SAVE FILE STARTING ADDRESS 

IRINGIO 1 MS. LOOP TIME CSN) 

i DEVICE ADDRESS FOR SYS.DR 

1 4 CONTIGUOUS BLOCKS FOR CORE IMAGES 

1NUMB PUSH LEVELS 

I EXTENSION OFFSET IN NAME AREA 

I WORDS PER RANDOM RECORD 

I INTERRUPT FLAG 

J CRITICAL READ ERROR 

J PANIC ON READ ERROR 

J BREAK FLAG 

J MAP LOCATION IN BOOTSTRAP 



JPARTIAL INIT WITH OVERLAYS 

J END OF CLI LOCATION IN BOOTSTRAP 
I DEVICE CODE OF BOOTSTRAP DEVICE 



i DEFINE THE EXCEPTIONAL STATUS CODES 



.DUSR 


ERFNO = 





• DUSR 


ERFNM= 


i 


• DUSR 


ERICM= 


2 


• DUSR 


ERICD= 


3 


• DUSR 


ERSV1= 


4 


.DUSR 


ERWR0= 


5 


.DUSR 


EREOF= 


6 


• DUSR 


ERRPR= 


7 


.DUSR 


ERWPR=^ 


10 


.DUSR 


ERCRE= 


11 


• DUSR 


ERDLE= 


12 


.DUSR 


ERDE1= 


13 


.DUSR 


ERCHA= 


14 


• DUSR 


ERFOP= 


1 5 


• DUSR 


ERUFT= 


21 


.DUSR 


ERLLI= 


22 


.DUSR 


ERRTN= 


23 


.DUSR 


ERPAR= 


24 


.DUSR 


ERCM3= 


2S 


.DUSR 


EhMEM= 


26 


• DUSR 


EhSPC= 


27 


• DUSR 


ERFIL= 


30 


.DUSR 


ERSEL= 


31 


• DUSR 


EhADh= 


32 


• DUSR 


ERRD = 


33 


• DUSR 


EhDIF< = 


35 


.DUSh 


EhDNM= 


36 


• DUSh 


EKOVN= 


37 


• DUSR 


EhOVA= 


40 


.DUSh 


EhTlM= 


41 


• DUSR 


ERNOT= 


42 


.DUSh 


EhXMT= 


43 


.DUSR 


ERSOF= 


44 


• DUSR 


ERIBS= 


45 


• DUSR 


ERICB= 


46 


.DUSR 


ERSIM= 


47 


• DUSR 


ERGTS= 


50 



i ILLEGAL CHANNEL NUMBER 

i ILLEGAL FILE NAME 

1 ILLEGAL SYSTEM COMMAND 

J ILLEGAL COMMAND FOR DEVICE 

J NOT A SAVED FILE 

1 ATTEMPT TO WRITE AN EXISTENT FILE 

1 END OF FILE 

J ATTEMPT TO READ A READ PROTECTED FILE 

i WRITE PROTECTED FILE 

J ATTEMPT TO CREATE AN EXISTENT FILE 

J A NON-EXISTENT FILE 

J ATTEMPT TO ALTER A PERMANENT FILE 

J ATTRIBUTES PROTECTED 

; FILE NOT OPENED 

S ATTEMPT TO USE A UFT ALREADY IN USE 

I LINE LIMIT EXCEEDED 

J ATTEMPT TO hESTORE A NON-EXISTENT IMAGE 

I PARITY ERROR ON READ LINE 

; TRYING TO PUSH TOO MANY LEVELS 

J NOT ENUF MEMORY AVAILABLE 

J OUT OF FILE SPACE 

i FILE HEAD ERROR 

J UNIT NOT PhOPEhLY SELECTEE) 

i ILLEGAL STARTING ADDRESS 

i ATTEMPT TO READ INTO SYSTEM AREA 

; FILES SPECIFIED ON DIFF. DIRECTORIES 

l ILLEGAL DEVICE NAME 

i ILLEGAL OVEhLAY NUMBER 

5 ILLEGAL OVEhLAY FILE ATTRIBUTE 

; USEh SET TIME EhhOR 

J OUT OF TCB'S 

; SIGNAL TO BUSY A DDR 

1 SQUASH FILE ERROh 

1 DEVICE ALREADY IN SYSTEM 

I INSUFFICENT CONTIGUOUS BLOCKS 

JQTY EhhOh 

J ERROh IN USER TASK QUEUE TBL 
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1 CLI ERROR CODES 



• DUSR 

• OUSR 

• DUSR 
.nucp 

• DUSR 
.DUSR 

• DUSR 

• DUSR 

• DUSR 

• DUSR 

• DUSR 

• DUSR 



CNEARi 
CILAT« 
CNDBD* 

wi^^f • w 

CNSAD* 
CCKER' 
CNSFS= 
CNACM* 
CILBK' 
CSPER« 
CPHER= 
CTMAR* 



100 
101 
102 

f ft *» 
I VJ 

104 
10S 
106 
10? 
110 
1 i i 
112 
113 



J DEFINE THE PANICS 



• DUSR 
.DUSR 



PNOP* 
POFFS= 



• 10 
1B11 



I NOT ENOUGH ARGUMENTS 

J ILLEGAL ATTRIBUTE 

JNO DEBUG ADDRESS 

I NO CONTINUATION ADDRESS 

INO STARTING ADDRESS 

I CHECKSUM ERROR 

INO SOURCE FILE SPECIFIED 

INOT A COMMAND 

I ILLEGAL BLOCK TYPE 

JNO FILES MATCH SPECIFIED 

I PHASE ERROR 

I TOO MANY ARGUMENTS 



J NOP MAGIC 
I OFFSET 



•DUSR PNSDE= 21*P0FFS*PN0P 

•DUSR PNCSO> 22*P0FFS+PN0P 

•DUSR PNQER= 23*P0FFS+PN0P 

•DUSR PNCDE* 25+P0FFS+PN0P 

•DUSR PNCRR= 2 6*P0FFS+PN0P 

•DUSR PNDPE* 27«P0FFS+PNOP 

•DUSR PNDPE* 27*POFFS*PNOP 



J SOMEBODY RAPED MY SYS.DR 

I SYSTEM STACK OVERFLOW 

IQUEUE ERROR-ILLEG BLK 

J CRITICAL DISK READ/WRITE ERROR 

I RUNAWAY READER 

IMOVING HEAD DISK ERROR 

J DISK PACK ERROR 



I DEFINE THE CHARACTERISTICS 



• DUSR 


DCCPO= 


1B15 


I 


• DUSR 


DCCGN= 


1B14 


1 


• DUSR 


DCIDI- 


1B13 


l 
t 


• DUSR 


DCCNF* 


1B12 


i 


• DUSR 


DCTO« 


1B11 


i 


• DUSR 


DCKEY's 


1B10 


I 


• DUSR 


DCNAF= 


1B9 


i 


• DUSR 


DCRAT= 


1B08 


I 


• DUSR 


DCPCK= 


1B07 


l 


• DUSR 


DCLAC= 


1B0 6 


t 


• DUSR 


DCSPO* 


IB0S 


i 


• DUSR 


DCFWD= 


1B04 


i 


• DUSR 


DCFFO= 


1B03 


t 


• DUSR 


DCLTU= 


1B02 


t 


• DUSR 


DCC80- 


1B01 


I 


• DUSR 


DCSPC= 


1B00 


1 
I 



DEVICE REQUIRING LEADER/TRAILER 

GRAPHICAL OUTPUT DEVICE WITHOUT TABBING 

HARDWARE 

INPUT DEVICE REQUIRING OPERATOR INTERVENTION 

OUTPUT DEVICE WITHOUT- FORM FEED HARDWARE 

TELETYPE OUTPUT DEVICE 

KEYBOARD DEVICE 

OUTPUT DEVICE REQUIRING NULLS AFTER FORM FEEDS 

RUBOUTS AFTER TABS REQUIRED 

DEVICE REQUIRING PARITY CHECK 

REQUIRES LINE FEEDS AFTER CARRIAGE RTN 

SPOOLABLE DEVICE 

FULL WORD DEVICE (ANYTHING GREATER THAN 

FORM FEEDS ON OPEN 

CHANGE LOWER CASE ASCII TO UPPER 

READ 80 COLUMS 

SPOOL CONTROL 

SET « SPOOLING ENABLED 

RESET = SPOOLING DISABLED 
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l USER STATUS TABLE (UST) TEMPLATE 

.DUSR UST= 400 1 START OF BACKGROUND USER STATUS AREA 

.DUSR USTP=12 JPZERO LOC FOR UST POINTER 

1 NOTE- USTP MUST CORRESPOND TO PARS PZERO ALLOCATIONS 



ZMAX 

START OF SYMBOL TABLE 

END OF SYMBOL TABLE 

NMAX 

STARTING ADDRESS 

DEBUGGER ADDRESS 

HIGHEST ADDRESS USED 

FORTRAN COMMON AREA SIZE 

INTERRUPT ADDRESS 

BREAK ADDRESS 

INITIAL START OF NREL CODE 

CURRENTLY ACTIVE TCB 

START OF ACTIVE TCB CHAIN 

START OF FREE TCB CHAIN 

NUMBER OF CHANNELS 

OVLY DIRECTORY ADDR 

FORTRAN STATE VARIABLE SAVE ROUTINE (OR 0) 

LAST ENTRY 



.DUSR 


USTPC= 







• DUSR 


USTZM= 


I 


J 


• DUSR 


USTSS= 


2 


J 


.DUSR 


USTES= 


3 


) 


.DUSR 


USTNM= 


4 


1 


• DUSR 


USTSA= 


5 


; 


.DUSR 


USTDA= 


6 


i 


• DUSR 


USTHU= 


7 


t 


.DUSR 


USTCS= 


10 


i 


.DUSR 


USTIT= 


11 


t 


• DUSR 


USTBR= 


12 


i 


• DUSR 


USTIN= 


13 


t 


.DUSR 


USTCT* 


14 


i 


.DUSR 


USTAC= 


15 


i 


.DUSR 


USTFC= 


1 6 


t 


.DUSR 


USTCH= 


17 


j 


.DUSR 


USTOD= 


20 


> 


• DUSR 


USTSV= 


21 


i 


.DUSR 


USTEN= 


USTSV 


i 



I DEFINE 8 SPARE WORDS 

.DUSR UFPT=30 JUSER FILE POINTER TABLE 



•DUSR TPC=0 
.DUSR TAC0*1 
.DUSR TAC1=2 
.DUSR TAC2»3 
•DUSR TAC3=4 
.DUSR TPRST=5 
•DUSR TSYS=6 
.DUSR TLNK=7 
.DUSR TUSP= 10 
• DUSR TELNdl 



J USER PC + CARRY 

JAC0 

IAC1 

1AC2 

JAC3 

> STATUS BITS ♦ PRIORITY 

J SYSTEM CALL WORD 

J LINK WORD 

JUSP 

J TCB EXTENTION ADDR 



•DUSR TLN=TELN-TPC*1 



STATUS BITSJ 1 B0 = TASK PENDED# 2B0 = WAITING FOR OVERLAY AREA 



.DUSR OVNDS= J DIRECTORY NODE TABLE START 

.DUSR OVDAD= 10 » DEV ADDR OF INDEX 

.DUSR OVIDX= 1 > OFFSET FOR INDEX 1 IN IV INDEX 

.DUSR OVNAD* 2 »NODE POINT 

•DUSR OVNLN= OVNAD-OVI DX+1 JLENGTH OF A NODE GLOP 

I OFFSETS FOR USER TASK QUEUE TABLE 



.DUSR 
.DUSR 
.DUSR 
.DUSR 
.DUSR 

.DUSR 

.DUSR 

• DUSR 

• DUSR 



QPC* J STARTING PC 

q NUM = i J NUMBER OF TIMES TO EXEC 

QTOV= 2 J OVERLAY 

QSH= 3 J STARTING HOUR 

QSMS= 4 J STARTING SEC IN HOUR 

QPRI=TPRST 1MUST BE SAME 

qrr= 6 J RERUN TIME INC IN SEC 

QTLNK=TLNK I MUST BE SAME 

QOCH= 10 J CHAN OVERLAYS OPEN ON 

fiCOND= 11 J TYPE OF OVLY LOAD 

QTLN= QCOND-QPC+1 
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THE STAND-ALONE OPERATING SYSTEM 
ORDER OF MAGNETIC TAPE AND CASSETTE FlLES 



Availahle to users with one or more cassette drives are cassettes numbered 085-000002, 
and 085-00003. Supplied to users with one or more magnetic tape drives is magnetic 
tape unit number 085-000004. Below are the order of files contained on each. 



FileO 
File 1 
File 2 
File 3 
File 4 
File 5 
File 6 



CASSETTES (Model #3235) 
085-000002: 

Core Image Loader /Writer 

Command Line Interpreter 

Text Editor 

Assembler 

Relocatable Loader 

Library File Editor 

SYSGEN 

085-000003: 



Cassette Library File 

SOS Library File 1 

Command Line Interpreter (RB) File 2 
Text Editor (RB) File 3 

Assembler (RB) File 4 

Relocatable Loader (RB) File 5 

Library File Editor (RB) File 6 

SYSGEN File 7 

Extended Assembler Command Definitions: 

File 8 
File 9 
File 10 
File 11 
File 12 



Nova Basic Instructions 

Floating Point Interpreter 

Operating Systems 
RDOS User Parameters 
SOS Stand-alone Parameters 
SOS User Application Parameters File 13 



MAGNETIC TAPE (Model #3236) 
085-000004: 

Core Image Loader /Writer File 

Command Line Interpreter File 1 

Text Editor File 2 

Assembler File 3 

Relocatable Loader File 4 

Library File Editor File 5 

SYSGEN File 6 

SOS Magnetic Tape Library File 7 

SOS Library File S 
Command Line Interpreter (RB) File 9 

Text Editor (RB) File 10 

Assembler (RB) File 11 

Relocatable Loader (RB) File 12 

Library File Editor (RB) File 13 

SYSGEN (RB) File 14 
Extended Assembler Command Definitions: 

Nova Basic Instructions File 15 

Floating Point Interpreter File 16 

Operating Systems File 17 

RDOS User Parameters File 18 

SOS Stand-alone Parameters File 19 
SOS User Application Parameters File 20 
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.ACHR global SOS subroutine B-8 
adding user-written device handlers 
ASCII I/O 3-2,3-3,3-4 
assembler (ASM) 5-3.A-1 
attributes, file (.GTATR) 3-3 



App. B 



binary block loader (BLDR) 5-3 

binary I/O 3-2,3-4 

bootstrapping core image loader/writer 

buffer status parameters D-5 

byte 

load (.LDB) B-9 

pointer 3-1 

store (.STB) B-9 



card reader (CDRDR) ($CDR) (.CDRD) 

driver i-3,2-1 

external symbol for 1-3 

response to SOS 3-6 
cassette (CTA) (CTADR) (.CTAD) 

channel number designators 2-1, C- 

driver 1-3,2-1 

file loading 5-3 

file name designators C-l 

files on C-l 

Initializing 5-3 

loading 5-3 

operation 1 -2 

releasing 5-4 

response to SOS 3-7 

unit drivers 2-1 



5-1 



INDEX 



command line Interpreter 
error codes D-7 

rn-.-KTri-arv*. ::nHpr Qfi£ 



1 ,T C,T ff 
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stack displacements 
command table 

builder program (CTB) 1-1, 1-2,4-2 ff 

displacements D-l 

entry 4-2 

switches D-l 
core image loader/writer 1-1, 1-2,5-lff 
CTADR (see cassette) 
CTU (see cassette) 



DCT B-l ff, D-3 
device 

characteristics mask 

magnetic tape or cassette 
on file opening 3-2 
settings 3-3 
control table (DCT) B-lff, D-3 
drivers 

external normal symbol for 1-3 
routines 2-1 

writing new App. B 
priority table B-l, B-3, B-4 
responses to SOS commands 3-7 
start, stop, and dispatch routines B-5 

. DISM global SOS routine B-9 

dispatch routine B-5 

DOS to SOS Interface Program (DSOSI) 1-1,1-2,4-1 

. DSI external normal for DSOSI 1-1 

DSOSI system program 1-1,1-2 
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CDRDR (see card reader) 

CDT (command dispatch table) B-2 

channels assigned devices 2-1 

channel-number to device map B-l, B-4 

character 

getting (.GCHAR) 3-5 

putting (.PCHAR) 3-5 

reading (.RCHR) B-8 

sending (.ACHR) B-8 
characteristics of devices 3-3 
CLI ( see command line interpreter) 
.CLOSE 3-2 

. CLS global SOS subroutine B-7 
closing device/file 3-2,3-7 
commands 

format 3-1 

list of 3-1 
command line 

analysis 4-2 ff 

continuation of 4-2 

deleting characters 4-2 

input buffer 4-3 

table builder (CTB) 4-2 ff 



EDIT (text editor) 5-3 

EOF 

magnetic tape terminator C-2 
on read 3-4 

error messages 3-6 

exceptional (error) return 

ERETR in SAVRE 4-1,4-2 
list of SOS errors 3-6, D-6 

extended assembler 5-3, A- 1 

extended relocatable loader 5-4, A-2 

external declarations 

needed for SAVRE 4-2 
undefined in SOS MAIN B-l 

file/ device 

attributes 3-3, D-5 

characteristics 3-3, D-5 

closing all 3-2 

getting attributes/characteristics 

opening 3-2 

reading from 3-2 

status parameters D-5 

transferring 5-4 

writing to 3-2,3-4 
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.GCHAR 
.GTATR 



3-5 
3-3 



HMA 3-5 



. IBUF global SOS subroutine B-4, B-8 
initialization of SOS (. SYSI) 3-2 
initialization of cassette or magnetic tape 5-3 
input/ output commands 3-2 ff 
interrupt 

dismissing a (. DISM) B-9 

handling B-4 



. LDB global SOS subroutine B-9 

levels of required device driver program B-l 

LFE 5-3 

library 

including new device driver in B-l 

SOS routines 1-1,1-2 
library file editor (LFE) 5-3 

line printer ($LPT) (LPTDR) (. LPTD) 1-3,2-1,3-7 
linkage, SOS B-5.D-2 
loading 

SOS 2-1 

utility programs 5-3,5-4 



magnetic tape 

channel number designators 

file name designators C-l 

files on C-l 

initializing 5-3 

loading 5-3 

number of drives C-l 

operation 1 -2 

parameters D-4 

record format C-l 

releasing 5-4 

response to SOS 3-7 
.MEM 3-5 
.MEMI 3-5 
memory commands 3-5 
MKSAVE 5-3 
MTADR (see magnetic tape) 
MTU (see magnetic tape) 



NMAX 

changing 3-5 

core image writer request 

determining 3-5 



1-1, C-l 
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.OPEN 3-2 

opening device/file 3-2, B-7 
. OPN global SOS subroutine B-7 
. OPPP priorities table B-l, B-3 



panics D-7 
paper tape 

input (PTRDR) ( $PTR) (. PTRU) 
driver 2-1 

external symbol for 1-3 
response to SOS 3-7 
interrupt routines B-4 
output (PTPDR) ($PTP) (. PTPD) 
driver 2-1 

external symbol for 1 -3 
response to SOS 3-7 
parameter tape App. D 
. PCHAR 3-5 

plotter (PLTDR) ($PLT) (.PLTD) 
driver 2-1 

external symbol for 1-3 
response to SOS 3-7 



. RCHR global SOS subroutine B-8 

. RDL 3-3 

. RDLI global SOS subroutine B-8 

. RDS 3-4 

. RDSE global SOS subroutine B-8 

reading 

line 2-3, B-8 
sequential 2-3, B-8 

record, magnetic tape C-l 

relocatable loader 5 -4, A -2 

.RESET 3-2 



save file 5-3 

save -restore (SAVRE) program 

sequential mode 

I/O commands 3-4,2-4 
subroutines B-6.B-7 

SOS 



4-1 



B-4 



3-2 



command dispatch routine 
global subroutine B-6ff 
initialization routine (.SYSI) 
library 1-1,2-1 
loading 1-1,1-2 
main program 1-1,1-2 

unresolved externals in B-l, B-3, B-4 
system constants D-6 
system parameter tape D-2 
tapes 1-1 

user application parameter tape 
. SOS external normal for SOS 1-1 



B-8 



.OBUF global SOS subroutine B-4, B-9 
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stack 

frame for linkage B-6 
popping multiple levels 4-1 

user sunnlipH 4-1 

stand-alone operating system (see SOS) 

start routine B-5 

status on return from SOS 2-1 

. STB global SOS routine B-9 

stop routine B-5 

.STTY(STTY) 1-3 

SYSGEN 5-4, Chapter 6, A -3 

. S YSI command 1-3,3-2 

system generation and configuration Chapter 6 

assembler for paper tape systems 6-2 

cassette or magnetic tape 6-3 

paper tape systems 6-1 

SYSGEN utility program A-3, 5-4 
. SYSTM mnemonic 3 - 1 
switches to command arguments 

alphabetic 4-2,4-3 

numeric 4-2 



tape (see magnetic and paper) 
teletype 

BTTYDR 2-1 

character I/O commands 3-5 

character I/O subroutines B-8 

drivers 2-1 

external symbols for 1-3 

STTY(.STTY) 1-3 

STTYDR 2-1 

$TTI response to SOS 3-7 

$TTO response to SOS 3-6 

$TTP response to SOS 3-6 

$TTR response to SOS 3-7 
text editor 5-3 A-3 
translate table for command line 4-2 

beginning address 4-4 

examples 4-3 



user application 

command table builder (CTB) 4-2 

parameter tape D-l 

routines Chapter 4 

save-restore (SAVRE) 4^-1 
user file pointer table (UFPT) D-8 
user file table (UFT) D-4 
user stack 

definition 4-1 

for CTB 4-4 

initialization 4-1 

pointer (USP) 4-1 



user stack pointer (USP) 

in SAVRE 4-1 

on return from CTB 4-4 
user status table (UST) D-8, D-2 
user task queue table D-8 



writing 

line 3-4, B-7 

sequential 3-4, B-7 
.WRL 3-4 

. WRLI global SOS subroutine B-7 
.WRS 3-4 
.WRSE global SOS subroutine B-7 



XFER 5-4 



utility program 

descriptions and operation Chapter 5 
input/output 2-2 
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CHANGES FROM REVISION 02 TO REVISION 03 OF THE STAND-ALONE OPERATING 
SYSTEM USER'S MANUAL 



Nature of Change 

i Introduction has been added to the manual. 

1-1 Three new tape numbers have been added to replace tape 

number 089-000890, Extended Assembler Command Definitions. 

1-1 A new device driver tape has been added for the support of a 

x«j*-t,«ji.uiiiii jjiiic ri-inici L/nvcii 

3-1 Description of the system command formats has been expanded; 

and further description is included concerning passing channel 
numbers through the use of AC2. 

3-1 First sentence, in third paragraph under STATUS ON RETURN 

FROM SYSTEM now reads: ". . . (as it is by the user of JSR). " 

3-2 Further description of the . OPEN command has been added. 

3-2, 3-3 Text has been changed to indicate that character strings are 
terminated by either carriage returns, form feeds, or nulls. 

3-6 . GTATR has been added to list of applicable commands for 

error code 0; and . RDL, . WRL, . RDS, . WRS have been added 
to applicable commands for error code 15. 

3-6 Further description is included on the functions performed by 

the $CDR on a . RDS. 

3-6 On a . RDL using the $CDR, a 12-11-0-1-2-3-4-5-6-7-8-9 

punch causes end of file. 

3-7 The line printer may be used for either 80-column or 

132- column printouts. 

4-3 First sentence, second paragraph now reads, "The user- 

supplied translate table (TRT) establishes the definition 
of bits 0-10 of this table. " 

5-3 Description of Loading an Absolute Binary Paper Tape has 

been further expanded. 
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New features have been implemented for the Stand-alone Operating System (SOS). Additionally, changes have 
been made to existing features of SOS. The additions and changes are described below. 

ADDED INFORMATION 
Special Keyboard Interrupts 

The User Status Table displacements USTIT and USTBR are now available for use to transfer control as a result 
of interrupts from special keyboard characters. These characters are CTRL A and CTRL C, respectively. When- 
ever the $TTI interrupt handler detects the receipt of a CTRL A character, it checks the contents of UST + USTIT; 
whenever it detects a CTRL C character, it checks the contents of UST + USTBR. In both cases if the contents of 
the UST location are or -1, the character (C or A) is treated as part of the normal input stream and no further 
action is taken. 

If the UST location contains anything else, control is unconditionally transferred to the address contained in that 
location. All I/O will be reset and interrupts will be enabled if the break character was a CTRL A and disabled 
if the character was CTRL C. 

The contents of UST + USTIT are never altered by SOS. When the SOS Relocatable Loader builds a load module, 
that location is initialized to -1. To receive control after CTRL A interrupts, the user program must change the 
location appropriately. The contents of UST + USTBR are set to the highest memory address by SOS whenever 
a . SYS1 command is executed. Therefore, if this location is left unchanged by the user, a CTRL C break results 
in a jump to the last memory address. The last memory location in a cassette or magnetic tape environment is 
usually the start of the core image loader. And, in a paper tape environment, the last memory location is the 
start of the absolute binary loader. 

UST+USTBR may point to any location, however. Whichever location it does point to is the address to which 
control will be passed when a CTRL C is detected (with all I/O cleared and interrupt disabled). Note that use of 
one of the control keys to stop a cassette or magnetic tape write operation could cause an incomplete file to be 
written to the tape. Therefore, subsequent errors in file positioning may occur unless the user performs a 
manual rewind. 

U tility Programs' Treatment of CTRL Characters 
All SOS Utility Programs, except the Editor, treat CTRL C and CTRL A interrupts in the following manner: 

CTRLC - terminate utility program 

- invoke either the core image loader or the absolute binary loader 
CTRL A - terminate current program activity, restart utility program 

The action taken by the Editor upon receipt of these control characters is: 

CTRL C - never causes any kind of a break under any circumstances 
CTRL A - If one of the following Editor commands is in progress: 

T, Y, N, E, or P 
causes a termination of the operation and a restart of the Editor with 
all I/O reset but with the input buffer intact. 

- Otherwise treated as part of the normal input stream and may be ignored, 
recognized jsa legal Insert character or as an illegal command depending 
upon its context in the input stream. 

CHANGED INFORMATION 

The 'II" command under tlic Text Editor now causes a jump ro the core image or absolute binary loaders. 

In the USTP. location I 2 now points to UST. 

A new switch has been added to the CL1 command. [NIT. The /F switch causes wo EOF records to be written 

to the appropriate cassette or magnetic tape unit, starting from the beginning of the tape. 

On page C-4 a reference is made to tape number 090-000890 under SYSCEN procedures for the Assembler. This 

tape has been replaced with three instruction tapes, numbered as follows. 

Extended Assembler Command Definitions 

Instruction definitions -Nova Basic Instructions 090-001482 

Instruction definitions-Floating Point Interpreter 090-001483 

Instruction definitions-Operating Systems 090-001484 



